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Manual Overview 



Chapter 



Introduction 

This manual is intended to present the concepts of computer interfacing that are relevant to 
programming the HP Series 200/300 computers. However, it is not a text dealing with computer 
architecture or hardware in general. It is intended to present the topics that will increase your 
understanding of interfacing to these computers. If you would like a more detailed discussion of the 
other concepts, you may want to consult a text on computer architecture. 



Note 

It may be necessary, depending on your computer system, to add 
certain drivers or keywords which are provided by loading BIN files. 



Manucd Organization 



This manual is organized by topics. The text is arranged to focus your attention on interfacing 
concepts rather than to present only a serial list of the BASIC-language I/O statements. Once 
you have read this manual and are familiar with the general and specific concepts involved, you 
can use either this manual or the BASIC Language Reference when searching for a particular 
detail of how a statement works. Keep in mind that this manual has been designed as a learning 
tool, not as a quick reference. 

This manual is designed for easy access by both beginners and experienced users. Experienced 
users may decide to go directly to the chapter that describes the interface to be used. If more 
background is required, the information in chapters 3 through 7 will provide further explana- 
tion. Less experienced users may want to begin with Chapter 2, "Interfacing Concepts", before 
reading about general or interface-specific techniques. It is recommended that less experienced 
users work through the BASIC Programming Techniques manual before using this manual. 

The brief descriptions in the next section will help you determine which chapters you will need 
to read for your particular application. 



2 Manual Overview 



Chapter Previews 

Chapter 2 - Interfacing Concepts 

This chapter presents a brief explanation of relevant interfacing concepts and terminology. This 
discussion is especially useful for beginners as it covers much of the why and how of of 
interfacing. Experienced programmers may also want to skim this material to better understand 
the terminology used in this manual. 

Chapter 3 - Directing Data Flow 

This chapter describes how to specify which computer resource is to send data to or receive data 
from the computer. The use of device selectors, string variable names, and I/O path names in I/O 
statements are described. 

Chapter 4 - Outputting Data 

This chapter presents methods of outputting data to devices. All details of this process are 
discussed, and several examples of free-field output and output using images are given. Since 
this chapter completely describes outputting data to devices, you may only need to read the 
sections relevant to your application. 

Chapter 5 - Entering Data 

This chapter presents methods of entering data from devices. All details of this process are 
discussed, and several examples of free-field enter and enter using images are given. As with 
Chapter 4, you may only need to read sections of this chapter relevant to your application. 

Chapter 6 - Registers 

This chapter describes the use and access of registers. The uses of registers are explained, and 
programming techniques used to examine and change register contents are presented. Indi- 
vidual interface register definitions are not contained in this chapter, but are discussed in the 
corresponding interface chapter. 

Chapter 7 - Interface Events 

This chapter describes event-initiated branching from an interface's point of view. The uses of 
both interrupts and timeouts are discussed, and several examples are given. Again, the inter- 
face-dependent details are not given in this chapter, but are covered in the chapter dedicated 
to discussing programming techniques for each interface. 

Chapter 8 - The Internal CRT Interface 

This chapter describes accessing the built-in CRT display through its interface to the computer. 
Since this device can be accessed via its interface, most of the programming techniques pre- 
sented in Chapters 3 through 7 can be used with this device. If you have no experience in 
programming interfaces, you will find this chapter very useful; many tools are presented that 
will help you program and understand the other interfaces. 

Chapter 9 - The Internal Keyboard Interface 

As with Chapter 8, this chapter describes several programming techniques applicable to inter- 
facing to the built-in keyboard, and several examples are given that will help you understand 
many of the general programming techniques presented in previous chapters. All of the capa- 
bilities of the keyboard are explained in this chapter. 
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Chapter 10 - I/O Path Attributes 

This chapter presents several powerful capabilities of the 1/0 path names provided by the 
BASIC language system. Interfacing to devices is compared to interfacing to mass storage files, 
and the benefits of using the same statements to access both types of resources are explained. 
This chapter is also highly recommended to all readers. 

Chapter 11 - Advanced Transfer Techniques 

This chapter describes advanced I/O techniques which can be used when communicating with 
devices. These techniques are generally used with devices which have data-transfer rates either 
much faster or much slower than the computer's normal transfer rate(s). 

Chapter 12 - The HP-IB Interface 

This chapter describes programming techniques specific to the HP-IB interface. Details of 
HP-IB communications processes are also included to promote better overall understanding of 
how this interface may be used. 

Chapter 13 - The Datacomin Interface 

This chapter describes the HP 98628 Data Communications Interface and presents program- 
ming techniques for using the asynchronous or HP Data Link protocols provided by this 
interface. 

Chapter 14 - RS-232 Serial Interface 

This chapter describes programming techniques specific to using the asynchronous-protocol 
capabilities of the HP 98626 Serial Interface. 

Chapter 15 - Powerfail Protection 

This chapter describes programming techniques for achieving powerfail protection (Option 050 
is required to use these capabilities). 

Chapter 16 - The GPIO Interface 

This chapter describes programming techniques specific to using the HP 98622 GPIO Interface. 

Chapter 17 - The BCD Interface 

This chapter describes programming techniques specific to using the HP 98623 BCD Interface. 

Chapter 18 - EPROM Programming 

This chapter describes how to program EPROMs (erasable programmable read only memory) 
using the HP 98255 EPROM Memory Card(s) and the HP 98253 EPROM Programmer Card. 
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Chapter 



Introduction 

This chapter describes the functions and requirements of interfaces between the computer and 
its resources. Concepts in this chapter are presented in an informal manner. All levels of 
programmers can gain useful background information that will increase their understanding of 
the why and how of interfacing. 



Terminology 

These terms are important to your understanding of the text of this manual. The purpose of this 
section is to make sure that our terms have the same meanings. 

The term computer is herein defined to be the processor, its support hardware, and the 
BASIC-language operating system; together these system elements manage all computer re- 
sources. The term computer resource is herein used to describe all of the "data-handling" 
elements of the system. Computer resources include: internal memory, CRT display, keyboard, 
and disc drive, and any external devices that are under computer control. 

The term hardware describes both the electrical connections and electronic devices that make 
up the circuits within the computer; any piece of hardware is an actual physical device. The 
term software describes the user-written, BASIC-language programs. Firmware refers to the 
pre-programmed, machine-language programs that are invoked by BASIC-language state- 
ments and commands. As the term implies, firmware cannot be modified by the user. The 
machine-language routines of the operating system are firmware programs. 
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The term I/O is an acronym that comes from "Input and Output"; it refers to the process of 
copying data to or from computer memory. Moving data from computer memory to another 
resource is called output. During output, the source of data is computer memory and the 
destination is any resource, including memory. Moving data from a resource to computer 
memory is input; the source is any resource and the destination is a variable in computer 
memory. Input is also referred to as enter in this manucd for the sake of avoiding confusion 
with the INPUT statement. 

The term bus refers to a common group of hardware lines that are used to transmit information 
between computer resources. The computer communicates directly with the internal resources 
through the data and control buses. The computer backplane is an extension of these internal 
data and control buses. The computer communicates indirectly with the external devices 
through interfaces connected to the backplane hardware. 
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Why Do You Need an Interface? 

The primary function of an interface is, obviously, to provide a communication path for data 
and commands between the computer and its resources. Interfaces act as intermediaries be- 
tween resources by handling part of the "bookkeeping" work, ensuring that this communica- 
tion process flows smoothly. The following paragraphs explain the need for interfaces. 

First, even though the computer backplane is driven by electronic hardware that generates and 
receives electrical signals, this hardware was not designed to be connected directly to external 
devices. The electronic backplane hardware has been designed with specific electrical logic 
levels and drive capability in mind. 



CAUTION 

EXCEEDING BACKPLANE HARDWARE RATINGS WILL DAM- 
AGE THE HARDWARE. 

Second, you cannot be assured that the connectors of the computer and peripheral are com- 
patible. In fact, there is a good probability that the connectors may not even mate properly, let 
alone that there is a one-to-one correspondence between each signal wire's function. 

Third, assuming that the connectors and signals are compatible, you have no guarantee that the 
data sent will be interpreted properly by the receiving device. Some peripherals expect single- 
bit serial data while others expect data to be in 8-bit parallel form. 

Fourth, there is no reason to believe that the computer and peripheral will be in agreement as to 
when the data transfer will occur; and when the transfer does begin the transfer rates will 
probably not match. As you can see, interfaces have a great responsibility to oversee the 
communication between computer and its resources. The functions of an interface are shown in 
the following block diagram. 
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Electrical and Mechanical Compatibility 

Electrical compatibility must be ensured before any thought of connecting two devices occurs. 
Often the two devices have input and output signals that do not match; if so, the interface 
serves to match the electrical levels of these signals before the physical connections are made. 

Mechanical compatibility simply means that the connector plugs must fit together properly. All 
of the computer interfaces have 100-pin connectors that mate with the computer backplane. 
The peripheral end of the interfaces may have unique configurations due to the fact that several 
types of peripherals are available that can be operated with the computer. Most of the interfaces 
have cables available that can be connected directly to the device so you don't have to wire the 
connector yourself. 

Data Compatibility 

Just as two people must speak a common language, the computer and peripheral must agree 
upon the form and meaning of data before communicating it. As a programmer, one of the 
most difficult compatibility requirements to fulfill before exchanging data is that the format 
and meaning of the data being sent is identical to that anticipated by the receiving device. 
Even though some interfaces format data, most interfaces have little responsibility for match- 
ing data formats; most interfaces merely move agreed-upon quantities of data to or from 
computer memory. The computer must generally make the necessary changes, if any, so that 
the receiving device gets meaningful information. 

Timing Compatibility 

Since all devices do not have standard data-transfer rates, nor do they always agree as to 
when the transfer will take place, a consensus between sending and receiving device must be 
made. If the sender and receiver can agree on both the transfer rate and beginning point (in 
time), the process can be made readily. 

If the data transfer is not begun at an agreed-upon point in time and at a known rate, the 
transfer must proceed one data item at a time with acknowledgement from the receiving 
device that it has the data and that the sender can transfer the next data item; this process is 
known as a "handshake". Both types of transfers are utilized with different interfaces and 
both will be fully described as necessary. 

Additional Interface Functions 

Another powerful feature of some interface cards is to relieve the computer of low-level tasks, 
such as performing data-transfer handshakes. This distribution of tasks eases some of the 
computer's burden and also decreases the otherwise-stringent response-time requirements of 
external devices. The actual tasks performed by each type of interface card vary widely and 
are described in the next section of this chapter. 
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Interface Overview 

Now that you see the need for interfaces, you should see what kinds of interfaces are available 
for the computer. Each of these interfaces is specifically designed for specific methods of data 
transfer; each interface's hardware configuration reflects its function. 

The HP-IB Interface 

This interface is Hewlett-Packard's implementation of the IEEE-488 1978 Standard Digital 
Interface for Programmable Instrumentation. The acronym "HP-IB" comes from Hewlett- 
Packard Interface Bus, often called the "bus". 
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Block Diagram of the HP-IB Interface 

The HP-IB interface fulfills all four compatibility requirements (hardware, electrical, data, and 
timing) with no additional modification. Just about all you need to do is connect the interface 
cable to the desired HP-IB device and begin programming. All resources connected to the 
computer through the HP-IB interface must adhere to this IEEE standard. 

The "bus" is somewhat of an independent entity; it is a communication arbitrator that pro- 
vides an organized protocol for communications between several devices. The bus can be 
configured in several ways. The devices on the bus can be configured to act as senders or 
receivers of data and control messages, depending on their capabilities. 



The RS-232 Serial Interface 

The serial interface changes 8-bit parallel data into bit-serial information and transmits the data 
through a two-wire (usually shielded) cable; data is received in this serial format and is con- 
verted back to parallel data. This use of two wires makes it more economical to transmit data 
over long distances than to use 8 individual lines. 
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Block Diagram of the Serial Interface 

Data is transmitted at several programmable rates using either a simple data handshake or no 
handshake at all. The main use of this interface is in communicating with simple devices. 

The Datacomm Interface 

This interface also changes 8-bit parallel data into bit-serial data (and vice versa) in a manner 
similar to the serial interface described above. However, the datacomm interface is controlled 
by a Z-80A microprocessor resident on the interface board, which implements high-level fea- 
tures such as inbound and outbound data buffers and the use of control blocks. The datacomm 
interface is intended for general data communications applications, most of which cannot be 
adequately handled by the serial interface. 

The GPIO Interface 

This interface provides the most flexibility of all the interfaces. It consists of 16 output-data 
lines, 16 input-data lines, two handshake lines, and other assorted control lines. Data is trans- 
mitted using programmable handshake conventions and logic senses. 
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The BCD Interface 

This interface is designed to be used with peripheral devices that implement a binary-coded 
decimal (BCD) data representation. Forty input lines allow up to ten BCD characters to be 
entered with one handshake cycle. Eight lines are available for data output. The interface 
provides great flexibility by allowing two peripheral devices to be connected and by featuring a 
binary-data operating mode. 



Data Representations 



As long as data is only being used internally, it really makes little difference how it is repre- 
sented; the computer always understands its own representations. However, when data is to 
be moved to or from an external resource, the data representation is of paramount impor- 
tance. 

Bits and Bytes 

Computer memory is no more than a large collection of individual bits (binary digits), each of 
which can take on one of two logic levels (high or low). Depending on how the computer 
interprets these bits, they may mean on or not on (off), true or not true (false), one or zero, busy 
or not busy, or any other bi-state condition. These logic levels are actually voltage levels of 
hardware locations within the computer. The following diagram shows the voltage of a point 
versus time and relates the voltage levels to logic levels. 
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In some cases, you want to determine the state of an individual bit (of a variable in computer 
memory, for instance). The logical binary functions (BIT, BINCMP, BINIOR, BINEOR, 
BINAND, ROTATE, and SHIFT) provide access to the individual bits of data. 

In most cases, these individual bits are not very useful by themselves, so the computer groups 
them into multiple-bit entities for the purpose of representing more complex data. Thus, all 
data in computer memory are somehow represented with binary numbers. 

The computer's hardware accesses groups of sixteen bits at one time through the internal data 
bus; this size group is known as a word. With this size of bit group, 65536 ( =2 f 16) different 
bit patterns can be produced. The computer can also use groups of eight bits at a time; this 
size group is known as a byte. With this smaller size of bit group, 256 ( = 2 | 8) different 
patterns can be produced. How the computer and its resources interpret these combinations 
of ones and zeros is very important and gives the computer all of its utility. 
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Representing Numbers 

The following binary weighting scheme is often used to represent numbers with a single data 
byte. Only the non-negative integers through 255 can be represented with this particular 
scheme. 



Most Significant Bit 



Least Significant Bit 
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Bit 
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Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Notice that the value of a 1 in each bit position is equal to the power of two of that position. For 
example, a 1 in the 0th bit position has a value of 1 ( == 2 f 0), a 1 in the 1st position has a value 
of 2 ( = 2 I 1), and so forth. The number that the byte represents is then the total of all the 
individual bit's values. 

Determining the Number Represented 



0*2t0 
1*211 
1*212 
0*213 
1 *2t4 
0*215 
0*216 




2 
4 

16 





Number represented = 



2 + 4 + 16 + 128 = 150 



1 * 2 t 7 = 128 

The preceding representation is used by the "NUM" function when it interprets a byte of 
data. The next section explains why the character "A" can be represented by a single byte. 

100 Niimbe r = NUM( "A" ) 

110 PRINT " Number = "; Number 

120 END 

Printed Result 

Number = 65 

Representing Characters 

Data stored for humans is often alphanumeric-type data. Since less than 256 characters are 
commonly used for general communication, a single data byte can be used to represent a 
character. The most widely used character set is defined by the ASCII standard'. This standard 
defines the correspondence between characters and bit patterns of individual bytes. Since this 
standard only defines 128 patterns (bit 7 = 0), 128 additional characters are defined by the 
computer (bit 7 == 1). The entire set of the 256 characters on the computer is hereafter called 
the "extended ASCII" character set. 



1 ASCII stands for "Amencdn Standard Code for Information Intcrcliange". Sec the Useful Tablrs for the compK'le table. 
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When the CHR$ function is used to interpret a byte of data, its argument must be specified by 
its binary-weighted value. The single (extended ASCII) character returned corresponds to the 
bit pattern of the function's argument. 



100 Number=G5 

110 PRINT " Character is 

120 PRINT CHR$(Nuwber) 

130 END 



! Bit pattern is "01000001 



Printed Result 

Character is A 

Representing Signed Integers 

There are two ways that the computer represents signed integers. The first uses a binary 
weighting scheme similar to that used by the NUM function. The second uses ASCII charac- 
ters to represent the integer in its decimal form. 

Internal Representation of Integers 

Bits of computer memory are also used to represent signed (positive and negative) integers. 
Since the range allowed by eight bits is only 256 integers, a word (two bytes) is used to 
represent integers. With this size of bit group, 65536 ( = 2 f 16) unique integers can be repre- 
sented. 



The range of integers that can be represented by 16 bits can arbitrarily begin at any point on the 
number line. In the computer, this range of integers has been chosen for maximum utility; it has 
been divided as symmetrically as possible about zero, with one of the bits used to indicate the 
sign of the integer. 

With this "2's-complement" notation, the most significant bit (bit 15) is used as b sign bit. A 
sign bit of indicates positive numbers and a sign bit of 1 indicates negatives. You still have 
the full range of numbers to work with, but the range of absolute magnitudes is divided in half 
(-32768 through 32767). The following 16-bit integers are represented using this 2's- 
complement format. 
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The representation of a positive integer is generated according to place value, just as when 
bytes are interpreted as numbers. To generate a negative number's representation, first derive 
the positive number's representation. Complement (change the ones to zeros and the zeros to 
ones) all bits, and then to this result add 1. The final result is the two's-complement repre- 
sentation of the negative integer. This notation is very convenient to use when performing 
math operations. Let's look at a simple addition of 2 two's-complement integers. 

Example: 3 + (-3) = ? 



First, +3 is represented as: 


0000 


0000 0000 


0011 


Now generate -3's representation: 








first complement +3, 


nil 


1111 nil 


1100 


then add 1 


+ 0000 


0000 0000 


0001 



-3's representation: 



nil nil nil iioi 



Now add the two numbers: 



final carry 
not used 



nil nil nil iioi 

+ 0000 0000 0000 0011 

1^ 1^ 

0000 0000 0000 0000 



carry on 
all places 



ASCII Representation of Integers 

ASCII digits are often used to represent integers. In this representation scheme, the decimal 
(rather than binary) value of the integer is formed by using the ASCII digits through 9 
{CHR$(48) through CHR$(57), respectively}. An example is shown below. 



Example 

The decimal representation of the binary value "1000 0000' 
representation consists of the following three characters. 



is 128. The ASCII-decimal 



Character 

Decimal value 
of character 

Binary value 
of character 



1 


2 


8 


49 


50 


56 


00110001 


00110010 


00111000 



Interfacing Concepts 15 



Representing Real Numbers 

Real numbers, like signed integers, can be represented in one of two ways with the computers. 
They are represented in a special binary mantissa-exponent notation within the computers for 
numerical calculations. During output and enter operations, they can also be represented with 
ASCII-decimal digits. 

Internal Representation of Real Numbers 

Real numbers are represented internally by using a special binary notation'. With this method, 
all numbers of the REAL data type are represented by eight bytes: 52 bits of mantissa magni- 
tude, 1 bit for mantissa sign, and 11 bits of exponent. The following equation and diagram 
illustrate the notation; the number represented is 1/3. 
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Binary value 
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00111111 
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11010101 


01010101 


01010101 




01010101 




V r- 









mantissa sign exponent 
Real number = (_ i)™n<is«a sign .2exponent-io23 .(., mantissa) 



mantissa 



Even though this notation is an international standard, most external devices don't use it; 
most use an ASCII-digit format to represent decimal numbers. The computer provides a means 
so that both types of representations can be used during I/O operations. 

ASCII Representation of Real Numbers 

The ASCII representation of real numbers is very similar to the ASCII representation of inte- 
gers. Sign, radix, and exponent information are included with ASCII-decimal digits to form 
these number representations. The following example shows the ASCII representation of 1/3. 
Even though, in this case, 18 characters are required to get the same accuracy as the eight- 
byte internal representation shown above, not all real numbers represented with this method 
require this many characters. 
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51 



1 The internal representation used for real numbers is the IEEE standard 64-bit floating-point notation. 



16 Interfacing Concepts 



The I/O Process 

When using statements that move data between memory and internal computer resources, 
you do not usually need to be concerned with the details of the operations. However, you 
may have wondered how the computer moves the data. This section takes you "behind the 
scenes" of I/O operations to give you a better intuitive feel for how the computer outputs and 
enters data. 

I/O Statements and Parameters 

The 1/0 process begins when an I/O statement is encountered in a program. The computer 
first determines the type of I/O statement to be executed (such as, OUTPUT, ENTER USING, 
etc.). Once the type of statement is determined, the computer evaluates the statement's 
parameters. 

Specifying a Resource 

Each resource must have a unique specifier that allows it to be accessed to the exclusion of all 
other resources connected to the computer. The methods of uniquely specifying resources 
(output destinations and enter sources) are device selectors, string variable names, and I/O 
path names. These specifiers are further described in the next chapter. 

For instance, before executing an OUTPUT statement, the computer first evaluates the 
parameter which specifies the destination resource. The source parameter of an ENTER state- 
ment is evaluated similarly. 

OUTPUT Dest-Paramete r JSource-item 

ENTER Sou rc_para mete r SDest-item 

Firmware 

After the computer has determined the resource with which it is to communicate, it "sets up" 
the moving process. The computer chooses the method of moving the specified data accord- 
ing to the type of resource specified and the type of 1/0 statement. The actual machine- 
language routine that executes the moving procedure is in firmware. Since there are differ- 
ences in how each resource represents and transfers data, a dedicated firmware routine must 
be used for each type of resource. After the appropriate firmware routine has been selected, 
the next parameter(s) must be evaluated (i.e., source items for OUTPUT statements and 
destination items for ENTER statements). 

Registers 

The computer must often read certain memory locations to determine which firmware 
routines will be called to execute the I/O procedure. The content of these locations, known as 
registers, store parameters such as the type of data representation to be used and type of 
interface involved in the I/O operation. 
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An example of register usage by firmware is during output to the CRT. Characters output to 
this device are displayed beginning at the current screen coordinates. After the computer has 
evaluated the first expression in the source-item list, it must determine where to begin display- 
ing the data on the screen. Two memory locations are dedicated to storing the "X" and "Y" 
screen coordinates. The firmware determines these coordinates and begins copying the data 
to the corresponding locations in display memory. 

The program can also determine the contents of these registers. The statements that provide 
access to the registers are described in Chapter 6. The contents of all registers accessible by 
the program are described in the interface programming chapters. 

Data Handshake 

Each byte (or word) of data is transferred with a procedure known as a data-transfer hand- 
shake (or simply "handshake"). It is the means of moving one byte of data at a time when the 
two devices are not in agreement as to the rate of data transfer or as to what point in time the 
transfer will begin. The steps of the handshake are as follows. 

1. The sender signals to get the receiver's attention. 

2. The receiver acknowledges that it is ready. 

3. A data byte (or word) is placed on the data bus. 

4. The receiver acknowledges that it has gotten the data item and is now busy. No further 
data may be sent until the receiver is ready. 

5. Repeat these steps if more data items are to be moved. 
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I/O Examples 

Now that you have seen all of the steps taken by the computer when executing an I/O state- 
ment, let's look at how two typical 1/0 statements are executed by the computer. 

Example Output Statement 

Data can be output to only one resource at a time with the OUTPUT statement (with the 
exception of the HP-IB Interface). This destination can be any computer resource, which is 
specified by the destination parameter as shown below. 

^ — the destination parameter 

OUTPUT Destination; St r in ^$ tCHR* ( C + 32 ) t "That ' s all" 



the source items are expressions 

The source of data for output operations is always memiory. Either string or numeric expres- 
sions can specify the actual data to be output. The flow of data during output operations is 
shown below. Notice that all data copied from memory to the destination resource by the 
OUTPUT statement passes through the processor under the control of operating-system firm- 
ware. 
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Data is Copied from Memory to a Resource During Output 

Source-Item Evaluation 

The source items, listed after the semicolon and separated by commas, can be any valid 
numeric or string expression. As the statement is being executed, these expressions must be 
individually evaluated and the resultant data representation sent to the specified destination. 
The results of the evaluation depend on the type of expression (numeric or string) and on 
which data representation (ASCII or internal) is to be used during the I/O operation. 

If the expression is a variable and the internal data representation is to be used, the data is 
ready to be copied byte-serially (or word-serially) to the destination; otherwise, the expression 
must be completely evaluated. The representation generated during the evaluation is stored in 
a temporary variable within memory. In both cases, once the beginning memory location and 
length of the data are known, the copying process can be initiated. 
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Copying Data to the Destination 

The computer employs "memory-mapped" I/O operations; all devices are addressable as 
memory locations. All output operations involve a series of two-step processes. The first step is 
to copy one byte (or word) from memory into the processor. The second step is then to copy 
this byte (or word) into the destination location (a memory address). Each item in the list is 
output in this serial fashion. The appropriate handshake firmware routine is executed for each 
byte (or word) to be copied. 

Since there may be several data items in the source list, it may be necessary to output an 
item-terminator character after each item to communicate the end of the item to the receiver. 
If the item is the last item in the source list, the computer may signal the receiver that the 
output operation is complete. Either an item terminator or end-of-line sequence of characters 
can be sent to the receiver to signal the end of this data transmission. The OUTPUT statement 
is described in full detail in Chapter 4. 

Example Enter Statement 

Data can be entered from only one resource at a time. This source can be any resource and is 
specified by the source parameter as shown in the following statement. 

-the source parameter 

ENTER Source JNumbe r »St r in3$ 



destination items are program variables 



The destinations of enter operations are always variables in memory. Both string and numeric 
variables can be specified as the destinations. The flow of data during enter operations is 
shown below. 



Internal Memory 



Source 
Expression(s) 



Data Flow 



String 
Variable 



TV 



Processor 



. Data Bus 



From Other Resources 



Data is Copied from a Resource to Memory During Enter 
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Destination-Item Evaluation 

The destination(s) of data to be entered is (are) specified in tfie destination list. Eitfier string or 
numeric variables can be specified, depending on the type of data to be entered. In general, 
as each destination item is evaluated, the computer finds its actual memory location so that 
data can be copied directly into the variable as the enter operation is executed. However, if 
the ASCII representation is in use, numeric data entered is stored in a temporary variable 
during entry. 

Copying Data into the Destinations 

As with output operations, entering data is a series of two-step processes. Each data byte (or 
word) received from the sender is entered into the processor by the appropriate handshake 
firmware. It is then copied into either a temporary variable or a program variable. If more than 
one variable is to receive data, each incoming data item must be properly terminated. If the 
internal representation is in use, the computer knows hou; many characters are to be entered 
for each variable. If the ASCII representation is in use, a terminator character (or signal) must 
be sent to locate the end of each data item. When all data for the item has been received, it is 
evaluated, and the resultant internal representation of the number is placed into the appropri- 
ate program variable. Further details concerning the E:NTER statement are contained in 
Chapter 5. 
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Chapter 



Introduction 

As described in the previous chapter, data can be moved between computer memory and 
several resources, including: 

• Computer memory (string variables in memory) 

• Internal and external devices 

• Mass storage files 

• Buffers 



This chapter describes how string variables and devices are specified in I/O statements. Speci- 
fying mass storage files in I/O statements is briefly described in Chapter 10 and in BASIC 
Programming Techniques. Buffers are described in Chapter 11. 
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Specifying a Resource 



Each resource must have a specifier that allows it to be accessed to the exclusion of all other 
computer resources. String variables are specified with their names, while devices can be 
specified with either their device selector or with a new data type known as an I/O path name. 
This section describes how to specify these resources in OUTPUT and ENTER statements. 

String-Variable Names 

Data is moved to and from string variables by specifying the string variable's name in an 
OUTPUT or ENTER statement. Examples of each are shown in the following program. 



IOC 
110 
12!! 
IGC 
l^C 
ISC 

isc 

17C 
IBC 
19C 
2 C 
21C 
22C 
23C 

2ac 

25C 
26C 
27C 
280 



DIM T _ d e 5 t $ C 80 ] » F r o m_ s o u r c e $ [ 80 ] 

DIM Data_out$C80] 

! 

F r m _ 5 u r c e $ = " S u r c e data" 
Data_out$="OUTPUT data" 
! 

PRINTER IS 1 

PRINT "To_dest$ before QUTPUT= "iTo-dest* 

PRINT 

I 

OUTPUT To_dest$ ;Data_out$ ; 

PRINT "To_dest$ after OUTPUT^ ";To_dest$ 

PRINT 
! 

ENTER Fro(Ti_source$;To_de5t$ 

PRINT "To_de5t$ after ENTER= ";To_de5t$ 

PRINT 



END 



Printed Results 

To_dest$ before OUT PUT = (null string) 
To-dest* after OUTPUT= OUTPUT data 



To_de5t$ after ENTER= Source data 

As with I/O operations between the computer and other resources, the source and destination 
of data are specified in software (in an I/O statement within a BASIC program). The data is 
then moved through a hardware path under operating-system firmware control. An overview 
of this process is illustrated in the following diagram. 
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Diagram of the Default I/O Path Used 
for String-Variable I/O Operations 

Data is always copied to the destination string (or from the source string) beginning at the first 
position of the variable; subscripts cannot be used to specify any other beginning position 
within the variable. 

The use of outputting to and entering from string variables is a very powerful method of 
buffering data to be output to other resources. With OUTPUT and ENTER statements that use 
images, the data sent to the string variables can be explicitly formatted before being sent to 
(or while being received from) the variable. Further uses of string variables are described in 
the section of Chapter 10 called "Applications of Unified I/O". 

Device Selectors 

Devices include the built-in CRT and keyboard, external printers and instruments, and all 
other physical entities that can be connected to the computer through an interface. Thus, 
each device connected to the computer can be accessed through its interface. 

Each interface has a unique number by which it is identified, known as its interface select 
code. The internal devices are accessed with the following, permanently assigned interface 
select codes. 

CRT Display 1 Display (bit-mapped graphics) 6 

Keyboard 2 Built-in HP-IB 7 

Display (graphics) 3 Parity checking (on memory), 

Intemal flexible disc drive 4 cache memory, and 

Optional powerfail protection 5 Floating-point math hardware 32 (pseudo) 
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Optional interfaces all have switch-settable select codes. These interfaces cannot use select 
codes 1 through 7; the valid range is 8 through 31. The following settings on optional inter- 
faces have been made at the factory but can be reset to any unique select code between 8 
and 31. See the interface's installation manual for further instructions. 

HP-IB 8 EPROM Programmer 27 

Serial 9 Color Output 28 

BCD 11 Bubble Memory 30 

GPIO 12 

High-speed HP-IB Disc 14 

Data Communications 20 

SRM 21 

Examples of using interface select codes to access devices are shown below. 

OUTPUT 1 ;"Data to CRT" 
ENTER 1 ;Crt_l irie$ 

Int_sel_code=12 

OUTPUT Irit_sel_code 5 St r i n s$6: " Ex p re s s i on " >Nurii_exp re ss i on 

ENTER Int_sel_code ;Str_uariable$ »Num_ variable 

Numbe r = 2 

ENTER 7 + Nu(iiber;Serial_data$ 

OUTPUT 1 1-Numbe r ; "Data to serial card" 

The device selector can be any numeric expression which rounds to an integer in the range 1 
through 32 (32 is a pseudo select code used as a device selector for parity, cache, and float 
registers). If the interface select code specifies an HP-IB interface, additional information must be 
specified to access a particular HP-IB device, since more than one device can be connected to the 
computer through HP-IB interfaces. 

HP-IB Device Selectors 

Each device on the HP-IB interface has a primary address by which it is uniquely identified; 
each address must be unique so that only one device is accessed when one address is specified. 
The device selector is then a combination of the interface select code and the device's 
address'. Two examples are shown below. 

To access the device on; 

interface select code 7 at primary address 01, use device selector 701 
interface select code 10 at primary address 13, use device selector 1013 



1 The HP-IB also has additional capabilities that add to this definition of device selectors. See Chapter 1 1 for further details. 
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Accessing devices with device selectors in BASIC statements is described in the following 
diagram. 
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Diagram of the Default I/O Path Used 
when a Device Selector is Specified 

Disc drives are also considered to be devices and are connected to the computer through 
interfaces. However, files on the disc media cannot be uniquely accessed with only the select 
code of its interface; additional information specifying which file is to be accessed must be 
included. Accessing mass storage files is fully described in the BASIC Language Reference 
and is compared to accessing devices in Chapter 10 of this manual. 

I/O Path Names 

As shown in the previous diagrams, all data entered into and output from the computer is 
moved through an "I/O path". An I/O path consists of the hardware and operating-system 
firmware used to carry out this moving process. When a string variable or device selector is 
specified in an ENTER or OUTPUT statement, the operating system first evaluates the ex- 
pression that specifies a resource and then chooses the corresponding defauh I/O path 
through which data will be moved. 

With the I/O language of the computer, the I/O paths to devices and mass storage files can be 
assigned special names; I/O paths to string variables can only be assigned names if the variable 
is declared as a buffer. Assigning names to I/O paths provides many improvements in perform- 
ance and additional capabilities over using device selectors, described in "Benefits of Using I/O 
Path Names" at the end of this chapter. 
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The concept of using I/O path names is shown in the following diagram; by comparing it to 
the previous diagram, you can see several major differences between using I/O path names 
and device selectors in I/O operations. These differences are described in the section of this 
chapter called "Benefits of Using I/O Path Names". 
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I/O Paths to Devices and Mass-Storage Files 



Assigning I/O Path Names 

An I/O path name is a new data type that can be assigned to either a device or a data file on a 
mass storage device. Any valid name' preceded by the "@" character can be used. Examples 
of the statement that makes this assignment are as follows. 

Examples 

ASSIGN @Di5Play TD 1 

ASSIGN @Pr inter TO 701 

ASSIGN iSerial TO 9 

ASSIGN iGpio TO 12 

Now you can use the I/O path names instead of the device selectors to specify the resource 
with which communication is to take place. 



1 A "name" is a combination of 1 to 15 characters, beginning with an uppercase alphabetical character or one of the characters CHR${161) 
through CHR$(254) and followed by up to 14 lowercase alphanumeric characters, the underbar character (_), or the characters CHR$(161) 
through CHR$(254). Numeric-variable names are examples of valid names. 
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OUTPUT iDisplay ; "Display message" 

OUTPUT @Printer;"Messa3e to the Printer" 

ENTER iSerial iUariable » Variable* 

ENTER @Gpio ;Wordl »Word2 

Since an I/O path name is a data type, a fixed amount of memory is allocated, or "reserved", 
for the variable similar to the manner in which memory is allocated for other program vari- 
ables (INTEGER, REAL, and string variables). Since the variable does not initially contain 
usable information, the validity flag, shown below, is set to false. When the ASSIGN state- 
ment is actually executed, the allocated memory space is then filled with information describ- 
ing the I/O path between the computer and the specified resource, and the validity flag is set 
to true. 

I/O Path Variable Contents 



validity flag 



type of resource 



device selector 
of resource 



additional information, 
if any, depends on the 
type of resource 



Attempting to use an I/O path name that does not appear in any program line results in error 
910 ("Identifier not found in this context"). This error message indicates that memory space 
has not been allocated for the variable. However, attempting to use an I/O path name that 
does appear in an ASSIGN statement in the program but which has not yet been executed 
results in error 177 ("Undefined I/O path name"). This error indicates that the memory space 
was allocated but the validity flag is still false; no valid information has been placed into the 
variable since the I/O path name has not yet been assigned to a resource. 

This I/O path information is only accessible to the context in which it was allocated, unless it is 
passed as a parameter or appears in the proper COM statements'. Thus, an I/O path name 
cannot be initially assigned from the keyboard, and it cannot be accessed from the keyboard 
unless it is presently assigned within the current context. However, an I/O path name can be 
re-assigned from the keyboard, as described in the next section. 

This information describing the I/O path is accessed by the operating system whenever the I/O 
path name is specified in subsequent I/O statements. A portion of this information can also be 
accessed with the STATUS and CONTROL statements described in Chapter 6. For now, the 
important point is that it contains a description of the resource sufficient to allow its access. 



1 See the BASIC Language Reference or BASIC Programming Techniques for further details. 
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Re-Assigning I/O Path Names 

If an I/O path name already assigned to a resource is to be re-assigned to another resource, 
the preceding form of the ASSIGN statement is also used. The resultant action is that the 
validity flag is first set false, implicitly "closing" the I/O path name to the device'. A "new 
assignment" is then made just as if the first assignment never existed. Making this new assign- 
ment places information describing the specified device into the variable and sets the validity 
flag true. An example is shown below. 

100 ASSIGN ePririter TO 1 ! Initial as s i Snmen t . 

110 OUTPUT ePrinte r ; "Datal " 

120 ! 

130 ASSIGN ePrinter TO 701 ! 2nd ASSIGN closes 1st 

lao OUTPUT @Printer ;"Data2" ! and makes a new assignment. 

150 PAUSE 

ISO END 

The result of running the program is that "Datal" is sent to the CRT, and "Data2" is sent to 
HP-IB device 701. Since the program was paused (which maintains the program context), the 
I/O path name @Printer can be used in an I/O statement or re-assigned to another resource 
from the keyboard. 

Closing I/O Path Names 

A second use of the ASSIGN statement is to explicitly close the name assigned to an I/O 
path. When the name is closed, the validity flag is set false, labeling the information as 
invalid'. Attempting to use the closed name results in error 177 ("Undefined I/O path name"). 
Examples of statements that close path names are as follows. 

Examples 

ASSIGN @Printer TO * 

ASSIGN @Serial_card TO * 

ASSIGN @Gpio TO * 

After executing this statement for a particular I/O path name, the name cannot be used in 
subsequent I/O statements until it is re-assigned. This same name can be assigned either to 
the same or to a different resource with a subsequent ASSIGN statement. However, if it is 
used prior to being re-assigned, error 177 occurs. 



1 Additional action may also be taken when the 1/0 path name assigned to a mass storage file is closed. 
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I/O Path Names in Subprograms 

When a subprogram (either a SUB subprogram or a user-defined function) is called, the 
"context" is changed to that of the called subprogram. The statements in the subprogram 
only have access to the data of the new context. Thus, in order to use an I/O path name in 
any statement within a subprogram, one of the following conditions must be true. 

• The I/O path name must already be assigned within the context (i.e., the same instance 
of the subprogram). 

• The I/O path name must be assigned in another context and passed to this context by 
reference (i.e., specified in both the formal-parameter and pass-parameter lists). 

• The I/O path name must be declared in a variable common (with COM statements) and 
already be assigned within a context that has access to that common block. 

The following paragraphs and examples further describe using I/O path names in subprog- 
rams. 

Assigning I/O Path Names Locally Within Subprograms 

Any I/O path name can be used in a subprogram if it has first been assigned to an I/O path 
within the same context of the subprogram. A typical example is shown below. 

10 CALL Subpro3ram_x 

20 END 

30 ! 

40 SUB Subpro3ram_x 

50 ASSIGN §Lo3_deyice TO 1 ! CRT. 

GO OUTPUT @Lo^_dey ice 5 "Subprogram" 

70 SUBEND 

When the subprogram is exited, all I/O path names assigned locally within the subprogram are 
automatically closed. If the program (or subprogram) that called the exited subprogram 
attempts to use the I/O path name, an error results. An example of this closing local I/O path 
names upon return from a subprogram is shown below. 

10 CALL Subprosraw-x 

11 OUTPUT @Lo 3_deu i ce 5 "Main " -< insert into previous 

20 END example. 

30 ! 

40 SUB SubproSram_x 

50 ASSIGN @Lo3_device TO 1 ! CRT. 

GO OUTPUT iLo^_deuice ; "Subprogram" 

70 SUBEND 

When the above program is run, error 177, "Undefined I/O path name", occurs in line 11. 
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Each context has its own set of local variables, which are not automatically accessible to any 
other context. Consequently, if the same I/O path name is assigned to 1/0 paths in separate 
contexts, the assignment local to the context is used while in that context. Upon return to the 
calling context, any I/O path names accessible to this context remain assigned as before the 
context was changed. 



1 ASSIGN @LoS_cleMice TO 701-« 1 insert these lines into 

2 OUTPUT @Lo 3_deM i ce ; "Fi rs t Mairi"-< ' previous example. 

10 CALL Subpro^ra(ii_x 

11 OUTPUT @Lo3_deuice; "Second Main"-* Change this line. 

20 END 

30 ! 

40 SUB Subpro^ram_x 

50 ASSIGN @LoS_deyice TO 1 ! CRT. 

SO OUTPUT @LoS_deuice ; "SubproSram" 

70 SUBEND 

The results of the above program are that the outputs "First Main" and "Second Main" are 
directed to device 701, while the output "Subprogram" is directed to the CRT. Notice that 
the original assignment of @Log_device to device selector 701 is "restored" when the sub- 
program's context is exited, since the assignment of @Log_device made to interface select 
code 1 was local to the subprogram. 

Passing I/O Path Names as Parameters 

I/O path names can be used in subprograms if they are assigned and have been passed to the 
called subprogram by reference; they cannot be passed by value. The I/O path name(s) to be 
used must appear in both the pass-parameter and formal-parameter lists. 

1 ASSIGN @LoS_dei.i ice TO 701 

2 OUTPUT @LoS_dei.iice ;"Fi rst Main" 

10 CALL S Li b p r ^ r a m _ X ( @ L 3 _ d e i.J i c e ) -• Add pass parameter, 

11 OUTPUT @LoS_dei.iice ; "Second Main" 
20 END 

30 ! 

40 SUB Sub P ro S ra(il_X ( @Lq 3 ) -< Add formal parameter. 

50 ASSIGN @Lo3 TO 1 ! CRT. 

GO OUTPUT @Lo3 ; "SubproS ratn" 

70 SUBEND 

Upon returning to the calling routine, any changes made to the assignment of the I/O path 
name passed by reference are maintained; the assignment local to the calling context is not 
restored as in the preceding example, since the I/O path name is accessible to both contexts. 
In this example, @Log_device remains assigned to interface select code 1; thus, "Subpro- 
gram" and "Second Main" are both directed to the CRT. 
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Declaring I/O Path Names in Common 

An I/O path name can also be accessed by a subprogram if it has been declared in a COM 
statement (labeled or unlabeled) common to calling and called contexts, as shown in the 
following example. 

1 COM @Lo S_deu i ce -• insert COM 

3 ASSIGN @LoS_deuice TO 701 statement, 

a OUTPUT @LoS_deuice ;"Fi rst Main" 



10 CALL Subpro 3 raw-x -• 

11 OUTPUT @Lo£(_deuice ;"Secorid Main' 
20 END 

30 ! 

^0 SUB Subpro3ram_x -< 



Parameters 
not necessary. 



41 COM §Lo ^_deu ice -« insert COM 

50 ASSIGN @LoS_deuice TO 1 ! CRT. statement. 

BO OUTPUT @Lo3_deuice ; "Subprogram" 

70 SUBEND 

If an I/O path name in common is modified in any way, the assignment is changed for all 
subsequent contexts; the original assignment is not "restored" upon exiting the subprogram. 
In this example, "First Main" is sent to HP-IB device 701, but "Subprogram" and "Second 
Main" are both directed to the CRT. This is identical to the preceding action when the I/O 
path name was passed by reference. 



Benefits of Using I/O Path Names 

Devices can be accessed with both device selectors and I/O path names, as shown in the 
previous discussions. With the information presented thus far, you may not see much differ- 
ence between using these two methods of accessing devices. This section describes these 
differences in order to help you decide which method may be better for your application. 

Execution Speed 

When a device selector is used in an I/O statement to specify the I/O path to a device, the 
numeric expression must be evaluated by the computer every time the statement is executed. 
If the expression is complex, this evaluation might take several milliseconds. 

device selector expression 



OUTPUT M a 1 u e _ 1 +B I T ( 1.1 a 1 u e _2 » 5-) *2 - 3 5 " D a t a " 

If a numeric variable is used to specify the device selector, this expression-evaluation time is 
reduced; this is the fastest execution possible when using device selectors. However, more 
information about the I/O process must be determined before it can be executed. 
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In addition to evaluating the numeric expression, the computer must determine which type of 
interface (HP-IB, GPIO, etc.) is present at the specified select code. Once the type of interface 
has been determined, the corresponding attributes of the I/O path must then be determined 
before the computer can use the I/O path. Only after all of this information is known can the 
process of actually copying the data be executed. 

If an I/O path name is specified in an OUTPUT or ENTER statement, all of this information 
has already been determined at the time the name was assigned to the I/O path. Thus, an I/O 
statement containing an I/O path name executes slightly faster than using the corresponding 
I/O statement containing a device selector (for the same set of source-list expressions). 

Re-Directing Data 

Using numeric-variable device selectors, as with I/O path names, allows a single statement to 
be used to move data between the computer and several devices. Simple examples of re- 
directing data in this manner are shown in the following programs. 

Example of Re-Directing with Device Selectors 

100 Deuice=:l 

110 GOBUB Data_out 



200 Deuice=9 

210 GOBUB Data-out 



^10 Data-out: OUTPUT Deuice;Data$ 
^20 RETURN 

Example of Re-Directing with I/O Path Names 

100 ASSIGN SDevice TO 1 
110 GOSUB Data-out 



200 ASSIGN §Deuice TO 9 
210 GOSUB Data-out 



410 Data-out: OUTPUT @De u i c e 5 Dat a$ 
420 RETURN 



Directing Data Flow 33 



The preceding two methods of re-directing data execute in approximately the same amount of 
time. As a comparison of the two methods, executing the "Device = " statement takes less 
time than executing the "ASSIGN @Device" statement. Conversely, executing the "OUT- 
PUT Device" statement takes more time than executing the "OUTPUT ©Device". However, 
the overall time for each method is approximately equal. 

There are two additional factors to be considered. First, device selectors cannot be used to 
direct data to mass storage files; I/O path names are the only access to files. If the data is ever to 
be directed to a file, you should use I/O path names. A good example of re-directing data to 
mass storage files is given in Chapter 10. The second additional factor is described below. 

Attribute Control 

I/O paths have certain "attributes" which control how the system handles data sent through the 
I/O path. For example, the FORMAT attribute possessed by an I/O path determines which data 
representation will be used by the path during communications. If the path possesses the 
attribute of FORMAT ON, the ASCII data representation will be used. This is the default 
attribute automatically assigned by the computer when I/O path names are assigned to device 
selectors. If the I/O path possesses the attribute of FORMAT OFF, the internal data representa- 
tion is used; this is the default format for BDAT files. Further details of these and additional 
attributes are discussed in Chapter 10. 

The second additional factor that favors using I/O path names is that you can control which 
attribute(s) are to be assigned to the I/O path to devices (and also to the I/O paths to files and 
buffers). If device selectors are used, this control is not possible. Chapter 10 describes how to 
specify the attributes to be assigned to an I/O path and gives several useful techniques for using 
the available attributes. 
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Outputting Data 



Chapter 



Introduction 

The preceding chapter described how to identify a specific device as the destination of data in 
an OUTPUT statement. Even though a few example statements were shown, the details of 
how the data are sent were not discussed. This chapter describes the topic of outputting data to 
devices; outputting data to string variables, buffers, and mass storage files is described in 
Chapters 10 and 11 of this manual, in Chapter 7 of BASIC Programming Techniques, and in 
the BASIC Language Reference. 

There are two general types of output operations. The first type, known as "free-field out- 
puts", use the computer's default data representations'. The second type provides precise 
control over each character sent to a device by allowing you to specify the exact "image" of 
the ASCII data to be output. 

The OUTPUT and ASSIGN keywords are in mainframe BASIC. You may have to load some 
BIN files, depending on your system, to make all of the examples work. 



Free-Field Outputs 

Free-field outputs are invoked when the following types of OUTPUT statements are executed. 
Examples 

OUTPUT iDeMice 53. 1 a*Rad i us -2 

OUTPUT Printerr'StririHT dat a" ;Num_l 

OUTPUT 9 5Test »Sco re »Student$ 

OUTPUT Escape_code*5CHR$(27)&:"&AlS" ! 

The Free-Field Convention 

The term "free-field" refers to the number of characters used to represent a data item. During 
free-field outputs, the computer does not send a constant number of ASCII characters for each 
type of data item, as is done during "fixed-field outputs" which use images. Instead, a special 
set of rules is used that govern the number and type of characters sent for each source item. The 
rules used for determining the characters output for numeric and string data are described in the 
following paragraphs. 

1 The ASCII representation described briefly in Chapter 2 is the default data representation used when communicating with with devices; 
however, the internal representation can also be used. See Chapter 10 for further details. 
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Standard Numeric Format 

The default data representation for devices is to use ASCII characters to represent numbers. 
The ASCII representation of each expression in the source list is generated during free-field 
output operations. Even though all REAL numbers have 15 (and INTEGERS can have up to 
5) significant decimal digits of accuracy, not all of these digits are output with free-field OUT- 
PUT Statements. Instead, the following rules of the free-field convention are used when gener- 
ating a number's ASCII representation. 

All numbers between IE -5 and IE -I- 6 are rounded to 12 significant digits and output in 
floating-point notation with no leading zeros. If the number is positive, a leading space is output 
for the sign; if negative, a leading " -" is output. 

Examples 

32767 
-32768 

123456.789012 
-.000123456789012 

If the number is less than IE - 5 or greater than IE -H 6, it is rounded to 12 significant digits and 
output in scientific notation. No leading zeros are output, and the sign character is a space for 
positive and " - '" for negative numbers. 

Examples 

-1.23456789012E + 6 
1.23456789012E-5 

Standard String Format 

The internal representation of string data consists of the string characters prefaced by a four- 
byte header that contains the length of the string (number of characters in the string). The 
data actually sent consists only of all actual data characters in the string; the length header is 
not output during free-field outputs in which the ASCII representation is being used. Thus, no 
leading or trailing spaces are output with the string's characters. 

Item Separators and Terminators 

Data items are output one byte (or word) at a time, beginning with the left-most item in the 
source list and continuing until all of the source items have been output. Items in the list must 
be separated by either a comma or a semicolon. However, items in the data output may or may 
not be separated by item terminators, depending on the use of item separators in the source 
lists. 

The general sequence of items in the data output is as follows. The end-of-line (EOL) sequence 
is discussed in the next section. 



1st 
item 


item 
terminator 


2nd 
item 


item 
terminator 




last 
item 


EOL 
sequence 



optional optional optional 
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Using a comma separator after an item specifies that the item terminator (corresponding to 
the type of item) will be output after the last character of this item. A carriage-return, 
CHR$(13), and a line-feed, CHR$(10), terminate string items. 

OUTPUT DfiMice 5"Item" f-1234 



1 


t 


e 


m 


OR 


LF 


- 


1 


2 


3 


4 


EOL 
sequence 



The default EOL sequence is a GR/LF. 

A comma separator specifies that a comma, CHR$(44), terminates numeric items. 
OUTPUT Deuice 5-123a»"Item': 



- 


1 


2 


3 


4 


• 


1 


t 


e 


m 


EOL 
sequence 



If a separator follows the last item in the list, the proper item terminator will be output instead 
of the EOL sequence. 



OUTPUT Deuice T'ltew" » 



OUTPUT Deuice 5-1234 t 



1 


t 


e 


m 


OR 


LF 



- 


1 


2 


3 


4 


, 



Using a semicolon separator suppresses output of the (otherwise automatic) item's termi- 
nator. 



OUTPUT 1 ;"Iteml" ;"ItefTi2' 



OUTPUT i;-i2;-3a 



1 


t 


e 


m 


1 


1 


t 


e 


m 


2 


EOL 
sequence 




- 


1 


2 


- 


3 


4 


EOL 
sequence 



If a semicolon separator follows the last item in the list, the EOL sequence and item termina- 
tors are suppressed. 

OUTPUT 1 r'lteml" ;"Itew2" ; 



1 


t 


e 


m 


1 


1 


t 


e 


m 


2 



Neither of the item terminators nor the EOL sequence are 
output. 
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If the item is an array, the separator following the array name determines what is output after 
each array element. (Individual elements are output in row-major order.) 



100 
110 
IZC 
13(: 

lac 

ISC 
IBC 

180 
190 
2 ( 
21( 

23(: 

2^0 
250 



OPTION BASE 1 
DIM A r r a y ( 2 . 3 ) 
FOR Row=l TO 2 

FOR Coliunn = l TO 3 

A r r a y ( R w » C o 1 u m n ) = R o w * 1 + C o 1 u ni n 

NEXT Column 
NEXT Row 
I 

OUTPUT i;Array(*) ! No trail! n 3 separato 
j 

OUTPUT i;Array(*)f ! Trailing comma. 
! 

OUTPUT i;Array(*)i ! Trailing semi -co Ion. 

! 

OUTPUT 1 ;"Done" 
END 



Resultant 


Output 










































1 


1 


■ 




1 


2 






1 


3 






2 


1 


■ 




2 


2 


' 




2 


3 


EOL 
sequence 




1 


1 


, 




1 


2 


, 




1 


3 






2 


1 






2 


2 


, 




2 


3 


, 




1 


1 




1 


2 




1 


3 




2 


1 




2 


2 




2 


3 






D 





N 


E 


EOL 
sequence 



























Item separators cause similar action for string arrays. 



IOC 

lie 

IZC 
IOC 
l^C 
ISC 
ISC 
17C 
ISC 
ISC 
20 C 
21C 
220 
230 
240 
250 
2 BO 



OPTION BASE 1 

DIM Array $(2»3)[2] 

FOR Row=l TO 2 

FOR Co 1 Limn = 1 TO 3 

Array* (Row tColumn ) =UAL* ( Row*l + Co 1 umn ) 

NEXT Column 
NEXT Row 
! 

OUTPUT i;Array*<*) 
! 

OUTPUT 1 ;Array$<*) » 
! 

OUTPUT 1 ;Array$(*) 5 

! 

OUTPUT i;"DONE" 

I 

END 



No trailing separator. 
Trailing comma. 
Trailing s e m i - c o 1 o n . 
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Resultant Output 






































1 


1 


CR 


LF 


1 


2 


CR 


LF 


1 


3 


CR 


LF 


2 


1 


CR 


LF 


2 


2 


CR 


LF 


2 


3 


EOL 
sequence 


1 


1 


CR 


LF 


1 


2 


CR 


LF 


1 


3 


CR 


LF 


2 


1 


CR 


LF 


2 


2 


CR 


LF 


2 


3 


EOL 
sequence 


1 


1 


1 


2 


1 


3 


2 


1 


2 


2 


2 


3 








D 





N 


E 


EOL 
sequence 

















A pad byte may be sent following the last character of the EOL sequence when using an I/O 
path that possesses the WORD attribute. See Chapter 10 for further information. 

Changing the EOL Sequence 

An end-of-line (EOL) sequence is normally sent following the last item sent with OUTPUT. The 
default EOL sequence consists of a carriage-return and line-feed (CR/LF), sent with no device- 
dependent END indication. It is also possible to define your own special EOL sequences that 
include sending special characters, sending an END indication, and delaying a specified amount 
of time after sending the EOL sequence. 

In order to define non-default EOL sequences to be sent by the OUTPUT statement, an I/O 
path must be used. The EOL sequence is specified in one of the ASSIGN statements which 
describe the I/O path. An example is as follows: 

ASSIGN SDevice TO IZSEDL "^f^f'^r" 



If you cannot interpret the " >>< " , refe r to the table for ASCII code and note that [ CTRL It J ) 
is equivalent to a line feed, [CTRL][ N ) to a carriage return. 

The characters in quotes are the EOL characters. Any character in the range CHR$(0) through 
CHR$(255) may be included in the string expression that defines the EOL characters; however, the 
length of the sequence is limited to eight characters or less. The characters are put into the output 
data before any conversion is performed (if CONVERT OUT is in effect). 

If END is included in the EOL attribute, an interface-dependent "END" indication is sent with (or 
after) the last character of the EOL sequence. However, if no EOL sequence is sent, the END 
indication is also suppressed. The following statement shows an example of defining the EOL 
sequence to include an END indication. 

ASSIGN iDeuice TO 205EOL CHR$ ( 13 ) &:CHR$ (10 ) END 



With the HP-IB Interface, the END indication is an End-or-Identify message (EOI) sent with the 
last EOL character. The individual chapter that describes programming each interface further 
describes each interface's END indication (if implemented). 

If DELAY is included, the system delays the specified number of seconds (after sending the last 
EOL character and/or END indication) before executing any subsequent BASIC statement. 

ASSIGN SDeuiceJEOL "^rI-p" DELAY 0.1 
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This parameter is useful when using slower devices which the computer can "overrun" if data 
are sent as rapidly as the computer can send them. For example, a printer connected to the 
computer through a serial interface set to operate at 300 baud might require a delay after 
receiving a CR character to allow the carriage to return before sending further characters. 

The default EOL sequence is a CR and LF sent with no END indication and no delay; this 
default can be restored by assigning EOL OFF to the 1/0 path. 

EOL sequences can also be sent by using the "L" image specifier. See "Outputs that Use 
Images" for further details. 

Using END in Free-Field OUTPUT 

The secondary keyword END may be optionally specified following the last source-item ex- 
pression in a freefield OUTPUT statement. The result is to suppress the End-of-Line (EOL) 
sequence that would otherwise be output after the last byte of the last source item. If a comma 
is used to separate the last item from the END keyword, the corresponding item terminator will 
be output as before (carrriage-return and line-feed for string items and comma for numeric 
items). 

Examples 

ASSIGN @Gpio to 12 



OUTPUT @Gpio 5-10 ,END 

Item terminator, but no EOL sequence, is sent. 



- 


1 








OUTPUT @gpio ;-io;end 

OUTPUT @Gpio;-10 END 



1 Neither Item terminator nor EOL sequence is sent. 



OUTPUT @Gpio ;"AB" tEND 



A B CR LF Item terminator, but no EOL sequence, is sent. 



OUTPUT iGpio ;"AB" ;END 
OUTPUT iGpio ;"AB" END 



A 


B 



Neither item terminator nor EOL sequence Is sent. 



OUTPUT @Gpio 

The EOL sequence is sent. 



EOL 
sequence 



OUTPUT @Gpio ;END 
OUTPUT @Gpioi"" END 



No EOL sequence Is sent. 
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The END keyword has additional significance when the destination is a mass storage file. See 
Chapter 7 of BASIC Programming Techniques for further details. 

Additional Definition 

BASIC language defines additional action when END is specified in a freefield OUTPUT state- 
ment directed to either HP-IB or Data Communications interfaces. 

END with HP-IB Interfaces 

With HP-IB interfaces, END has the additional function of sending the End-or-Identify signal 
(EOI) with the last data byte of the last source item; however, if no data are sent from the last 
source item, EOI is not sent. For further description of the EOI signal, see Chapter 12. 

Examples 

ASSIGN iDevice TO 701 



OUTPUT SDeuice 5-10 »END 





1 





, 



EOI sent with the last character 
(numeric item terminator). 

OUTPUT @Deuice ;"AB" ;END 
OUTPUT @Dei.>ice ;"AB" END 



A 


B 



EOI sent with the last character of the item. 

OUTPUT iDeuice JEND 
OUTPUT iDeuicei"" END 

Neither EOL sequence nor EOI is sent, since no data is sent. 

END with the Data Communications Interface 

With Data Communication interfaces, END has the additional function of sending an end-of- 
data indication to the interface. See Chapter 13 for further details. 
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Outputs that Use Images 

The free-field form of the OUTPUT statement is very convenient to use. However, there may 
be times when the data output by the free-field convention is not compatible with the data 
required by the receiving device. 

Several instances for which you might need to format outputs are: special control characters 
are to be output; the EOL sequence (carriage-return and line-feed) needs to be suppressed; 
or the exponent of a number must have only one digit. This section shows you how to use 
image specifiers to create your own, unique data representations for output operations. 

The OUTPUT USING Statement 

When this form of the OUTPUT statement is used, the data is output according to the format 
image referenced by the "USING" secondary keyword. This image consists of one or more 
individual image specifiers which describe the type and number of data bytes (or words) to be 
output.The image can be either a string literal, a string variable, or the line label or number of 
an IMAGE statement. Examples of these four possibilities are listed below. 

1. 100 OUTPUT 1 USING " BA ,SDDD . ODD »3)< " ; " K= ">123.a5 

2. 100 IfTiaSe-st r$="BA tSDDD.DDD »3>(" 

110 OUTPUT 1 USING I ma ^e_s t r$ 5 " K= ",123.45 

3. 100 OUTPUT 1 USING I ma Se_5 tmt 5 " K = ",123,45 
110 Ima^e_stmt: IMAGE GA ,SDDD , DDD ,3X 

4. 100 OUTPUT 1 USING 1105" K= ",123,45 
110 IMAGE BA ,SDDD.DDD,3>( 



Images 

Images are used to specify the desired format of data to be output. Each image consists of 
groups of individual image (or "field") specifiers which either describe the desired format of 
each item in the source list or specify that special characters are to be output. Thus, you can 
think of the image list as either a precise format description or as a procedure. It is 

convenient to talk about the image list as a procedure for the purpose of explaining how this 
type of OUTPUT statement is executed. 

Again, each image list consists of images that each describe the format of a data item to be 
output. The order of images in the list corresponds to the order of data items in the source list. 
In addition, image specifiers can be added to output (or to suppress the output of) certain 
characters. The following example steps through exactly how the computer executes all of the 
preceding equivalent statements. 
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Example of Using an Image 

We will use the first of the four, equivalent output statements shown above. Don't worry if 
you don't understand each of the image specifiers used in the image list; each will be fully 
described in subsequent sections of this chapter. The main emphasis of this example is that 
you will see how an image list is used to govern the type and number of characters output. 

OUTPUT 1 USING "GA tSDDD,DDD,3X" ?" K= "»123.a5 

The data stream output by the computer is as follows. 





K 


= 








+ 


1 


2 


3 


. 


4 


5 











CR 


LF 





6A 



D D 



3X 



default EOL 
sequence 



Step 1. The computer evaluates the first image in the list. Generally, each group of specifiers 
separated by commas is an "image"; the commas tell the computer that the image is 
complete and that it can be "processed". In general, each group of specifiers is 
processed before going on to the next group. In this case, 6 alphanumeric characters 
taken from the first item in the source list are to be output. 

Step 2. The computer then evaluates the first item in the source list and begins outputting it, 
one byte (or word) at a time. After the 4th character, the first expression has been 
"exhausted". In order to satisfy the corresponding specifier, two spaces (alpha- 
numeric "fill" characters) are output. 

Step 3. The computer evaluates the next image (note that this image consists of several 
different image specifiers). The "S" specifier requires that a sign character be out- 
put for the number, the "D" specifiers require digits of a number, and the "." 
specifies where the decimal point will be placed. Thus, the number of digits follow- 
ing the decimal point have been specified. All of these specifiers describe the format 
of the next item in the source list. 

Step 4. The next data item in the source list is evaluated. The resultant number is output one 
digit at a time, according to its image specifiers. A trailing zero has been added to the 
number to satisfy the "DDD" specifiers following the decimal point. 

Step 5. The next image in the list ("3X")is evaluated. This specifier does not "require" 
data, so the source list needs no corresponding expression. Three spaces are output 
by this image. 

Step 6. Since the entire image list and source list have been "exhausted", the computer 
then outputs the current (or default, if none has been specified) "end-of-line" sequ- 
ence of characters (here we assume that a carriage-return and line-feed are the 
current EOL sequence). 

The execution of the statement is now complete. As you can see, the data specified in the 
source list must match those specified in the output image in type and in number of items. 
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Image Definitions During Outputs 

This section describes the definitions of each of the image specifiers when referenced by 
OUTPUT statements. The specifiers have been categorized by data type. It is suggested that 
you scan through the description of each specifier and look over the examples. You are also 
highly encouraged to experiment with the use of these concepts. 

Numeric Images 

The digit, sign, and radix image specifiers are used to describe the format of numbers. 

Sign, Digit, Radix and Exponent Specifiers 



Image 
Specifier 



M 
S 
D 



R 

E 



ESZ 

ESZZ 

ESZZZ 

K, -K 



H, -H 



Meaning 



for 



for 



Specifies that a leading space for positive numbers or a leading "-' 
negative numbers is to be output. 

Specifies that a leading " + " for positive numbers or a leading " — ' 
negative numbers is to be output. 

Specifies that one ASCII digit ("0" through "9") is to be output. Leading 
spaces and trailing zeros are used as fill characters. The sign character, if 
any, "floats" to the immediate left of the most significant digit. If the num- 
ber is negative and neither S nor M is included, one digit position will be 
used for the minus sign. 

Like D, except that zeros are output as leading fill characters (instead of 
spaces). This specifier cannot appear to the right of a radix specifier (decim- 
al point or R). 

Like D, except that asterisks are output as leading fill characters (instead of 
spaces). This specifier cannot appear to the right of a radix specifier (decim- 
al point or R). 

Specifies the position of the decimal-point radix indicator (American radix) 
within a number. There can be only one radix indicator per numeric image 
item. 

Specifies the position of a comma radix indicator (European radix) within a 
number. There can be only one radix specifier per numeric image item. 

Specifies that the number is to be output using scientific notation. The E 
specifier must be preceded by at least one digit specifier (D, Z. or *). If no S 
and Z specifiers follow the E, a four-character exponent consisting of an 
"E" followed by the exponent sign and two exponent digits is output. This 
default exponent is equivalent to an ESZZ exponent specifier. Since the 
number is left-justified in the specified digit field (with scientific notation), 
the image for a negative number must contain a sign specifier (S or M). 

Like E, except that only one exponent digit is output. 

Same as E. 

Like E, except that three exponent digits are output. 

Specifies that the number is to be output in "compact" format, similar to 
the standard numeric format; however, neither a leading space (that would 
otherwise replace a "-I-" sign) nor a numeric item terminator (comma) is 
output. 

Like K, except the number is to be output using a comma radix (European 
radix). 
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Numeric Examples 

OUTPUT SDevice USING "DDDD" i - 123 . 7G9 



- 


1 


2 


4 


EOL 
sequence 



OUTPUT @Deyice USING "2D";-1.2 



- 


1 


EOL 
sequence 



OUTPUT @Device USING "ZZ . DD" 5 1 . B75 






1 




6 


8 


EOL 
sequence 



OUTPUT eOevice USING "Z.D";.35 








4 


EOL 
sequence 



OUTPUT iDevice USING "DD . E" ! 123a5 



1 


2 




E 


+ 





3 


EOL 
sequence 



OUTPUT iDeuice USING "2D . DDE" ;2E-a 



2 













E 


- 





5 


EOL 
sequence 



OUTPUT @Deuice USING "K"512.-aOO 



1 


2 




4 


EOL 
sequence 



OUTPUT 1 USING "HDD. 2D" 5-12.449 



- 


1 


2 




4 


5 


EOL 
sequence 



OUTPUT 1 USING "MDD.DD" ;2.0g 







2 







9 


EOL 
sequence 



OUTPUT 1 USING "SD.D";2.aag 



+ 


2 




4 


EOL 
sequence 



OUTPUT 1 USING "SZ.DD";.43 



+ 







4 


9 


EOL 
sequence 



OUTPUT 1 USING "SDD.DDE" ;-2.35 



- 


2 


3 




5 





E 


- 





1 


EOL 
sequence 
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OUTPUT iDeuice USING "**.D";2.B 



* 


2 


6 


EOL 

sequence 



OUTPUT iDeuice USING " DRDD " 5 3 . 1 4 1 B 



3 


■ 


1 


4 


EOL 
sequence 



OUTPUT eOeuice USING "H" 53. 1416 



3 


■ 


1 


4 


1 


6 


EOL 
sequence 



String Images 

These types of image specifiers are used to describe the format of string data. 



Image 
Specifier 



Character Specifiers 



Meaning 



"literal' 



K, K 
H, -H 



Specifies that one character is to be output. Trailing spaces are used as fill 
characters if the string contains less than the number of characters speci- 
fied. 

All characters placed in quotes form a string literal, which is output exactly 
as is. Literals can be placed in output innages which are part of OUTPUT 
statements by enclosing them in double quotes. 

Specifies that the string is to be output in "compact" format, similar to the 
standard string format; however, no item terminators are output as with 
the standard string format. 



String Examples 



OUTPUT eOeuice USING " BA " ! " Ch a rac t e r i 



EOL 
sequence 



OUTPUT eOeuice USING "K»""Literal 5"AB" 



A 


B 


L 


i 


t 


e 


r 


a 


1 


EOL 
sequence 



OUTPUT @Deuice USING "K";" Hello 









H 


e 


1 


1 











EOL 
sequence 



OUTPUT iDeuice USING "5A";" Hello 









H 


e 


EOL 

sequence 
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Binary Images 

These image specifiers are used to output bytes (8-bit data) and words (16-bit data) to the 
destination. Typical uses are to output non-ASCII characters or integers in their internal repre- 
sentation. 



Image 
Specifier 



Binary Specifiers 
Meaning 



B 



W 



Specifies that one byte (8 bits) of data is to be output. The corresponding 
numeric expression is evaluated, rounded to an integer, and interpreted 
MOD 256. If it is less than - 32 768, then CHR$(0) is output; if it is greater 
than 32 767, then CHR$(255) is output. 

Specifies that one word (16 bits) of data is to be sent as a 16-bit, two's- 
complement integer. The corresponding numeric item is rounded to an 
integer. If it is greater than 32 767, then 32 767 is sent; if it is less than 
- 32 768, then - 32 768 is sent. If either an 1/0 path name with the BYTE 
attribute (see Chapter 10) or a device selector is used to access an 8-bit 
interface, two bytes will be output; the first byte output is most significant. If 
an 1/0 path name with the BYTE attribute is used to access a 16-bit inter- 
face, the BYTE attribute is overridden and one word is output in a single 
operation. If an I/O path name with the WORD attribute is used to access a 
16-bit interface, a pad byte, CHR$(0), is output whenever necessary to 
achieve alignment on a word boundary. If the destination is a BDAT file, 
string variable, or buffer, the WORD attribute is ignored and all data are 
sent as bytes; however, pad byte(s) will also be output when necessary to 
achieve alignment on a word boundary. The pad byte may be changed by 
using the CONVERT attribute, if desired (see Chapter 10). 

Like W, except that no pad bytes are output to achieve word alignment. If 
an 1/0 path with the BYTE attribute is used to access a 16-bit interface, the 
attribute is not overridden (as with the W specifier). 



Binary Examples 

OUTPUT iDeuice USING " B »B »B " ;B5 »BG ♦B? 



A 


B 


C 


EOL 
sequence 



OUTPUT eOeuice USING "tt»B";i3 



CR 



OUTPUT SDeuice USING " W " ; B5*25G + BB 



A 


B 


EOL 
sequence 



48 Outputting Data 



For this example, assume that @Device possesses the WORD attribute and that the EOL 
sequence consists of the characters "123" with an END indication. 

OUTPUT @Deyice USING " K *N " ; "Od d " ,25G*B5 + GG 






d 


d 


NUL 


A 


B 


1 


2 


3 


NUL 






















' \ 



Word 1 Word 2 Word 3 Word 4 Word 5 END Indication Sent Here 



For this example, assume that ©Device possesses the WORD attribute and that the EOL 
sequence is the default (CR/LF). 

OUTPUT iDeuice USING " K » Y " 5 " Od d " * 25G*G5 + GB 






d 


d 


A 


B 


CR 


LF 


NUL 



Word 1 Word 2 Word 3 Word 4 



Special-Character Images 

These specifiers require no corresponding .data in the source list. They can be used to output 
spaces, end-of-line sequences, and form-feed characters. 

Special-Character Specifiers 



Image 
Specifier 


Meaning 


X 


Specifies that a space character, CHR$(32), is to be output. 


/ 


Specifies that a carriage-return, CHR$(13), and a line-feed character, 
CHR$(10), are to be output. 


@ 


Specifies that a form-feed character, CHR$(12), is to be output. 



Special-Character Examples 



OUTPUT @Dei,Jice USING " A »aX » A" ! "M" » " A" 



M 










A EOL 
sequence 



OUTPUT eOeuice USING "SOX" 



«— (50 spaces)— 


EOL 
sequence 



OUTPUT eOeuice USING "@./" 



FF 


CR 


LF 


EOL 
sequence 



OUTPUT @Deyice USING "/" 



CR 


LF 


EOL 
sequence 
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Termination Images 

These specifiers are used to output or suppress the end-of-line sequence output after the last 
data item. 



Image 
Specifier 



# 
% 

+ 



Termination Specifiers 
Meaning 



Outputs the current end-of-line (EOL) sequence. The default EOL charac- 
ters are CR and LF; see "Changing the EOL Sequence" for details regard- 
ing re-defining the EOL sequence. If the destination is an I/O path name 
with the WORD attribute, a pad byte will be output after each EOL sequ- 
ence when necessary to achieve word alignment. 

Specifies that the current EOL sequence which normally follows the last 
item is to be suppressed. 

Is ignored in output images but is allowed to be compatible with ENTER 
images. 

Specifies that the current EOL sequence which normally follows the last 
item is to be replaced by a single carriage-return character (CR). 

Specifies that the current EOL sequence which normally follows the last 
item is to be replaced by a single line-feed character (LF). 



Termination Examples 

OUTPUT SDeyice USING " aA »L" 5 "Dat a " 



D 


a 


t 


a 


EOL 
sequence 


EOL 
sequence 



OUTPUT iDeuice USING "« tK " 5 "Data" 



D 


a 


t 


a 



OUTPUT iDewice USING "».B";i2 



FF 



OUTPUT (aOeyice USING "+>K";"Data" 



D 


a 


t 


a 


CR 



OUTPUT @Dei.'ice USING " - » L »K " 5 " Dat a' 



EOL 
sequence 


D 


a 


t 


a 


LF 
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Additional Image Features 

Several additional features of outputs which use images are available with the computer. 
Several of these features, which have already been shown, will be explained here in detail. 

Repeat Factors 

Many of the specifiers can be repeated without having to explicitly list the specifier as many 
times as it is to be repeated. For instance, to a character field of 15 characters, you do not 
need to use "AAAAAAAAAAAAAAA"; instead, you merely specify the number of times that 
the specifier is to be repeated in front of the image ("15A"). The following specifiers can be 
repeated by specifying an integer repeat factor; the specii'iers not listed cannot be repeated in 
this manner. 

Repeatable Specifiers 

Z, D, A, X, /, @, L 

Examples 

OUTPUT @DeMice USING " ^Z . 3D " J 328 . 03 






3 


2 


8 







3 





EOL 
sequence 



OUTPUT @Deuice USING "GA";"Data bytes" 



EOL 
sequence 



OUTPUT @Deuice USING "5X »2A" 5 "Dat a' 













D 


a EOL 
sequence 



OUTPUT iDeuice USING "2L >^A " 5 "Dat a' 



EOL 
sequence 


EOL 
sequence 


D 


a t 


a 


EOL 
sequence 



OUTPUT eOeuice USING " 8A >2i " ? " Th e End' 



T 


h 


e 




E 


n 


d 




FF 


FF 


EOL 
sequence 



OUTPUT iDeuice USING "2/ 



OR 


LF 


OR 


LF 


EOL 
sequence 
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Image Re-Use 

If the number of items in the source list exceeds the number of matching specifiers in the 
image list, the computer attempts to re-use the image(s) beginning with the first image. 

110 ASSIGN eOevice TO 1 
120 Nu(rt_l = l 
130 Num_2=2 

lao ! 

150 OUTPUT SDeyice USING "K " ;Nu(ii_1 » "Dat a_l " »Num_2 » "Dat a_2" 
ISO OUTPUT SDevice USING "K . / " ;NufTi_l » "Oata_l " *NufTi_2 > "Dat a_2" 
170 END 

Resultant Display 

lData_12Data_2 
1 

Data_l 
2 
Data_2 



Since the "K" specifier can be used with both numeric and string data, the above OUTPUT 
statements can re-use the image list for all items in the source list. If any item cannot be 
output using the corresponding image item, an error results. In the following example, "Error 
100 in 150" occurs due to data mismatch. 

TO 1 



USING "DD.DD" ;Nuw_1 fNLim_2 »"Data_l 



110 


ASSIGN eDeuice 


120 


Num_l=l 


130 


Num_2=2 


lao 


! 


150 


OUTPUT eOeyice 


IBO 


END 
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Nested Images 

Another convenient capability of images is that they can be nested within parentheses. The 
entire image list within the parentheses will be used the number of times specified by the 
repeat factor preceding the first parenthesis. The following program is an example of this 
feature. 

100 ASSIGN SDeuice TO 701 

110 ! 

120 OUTPUT iDeuice USING " 3 ( B ) »X .DD ,X »DD " J 65 *BB ,67 >B8 »G9 

130 END 

Resultant Output 



A 


B 


C 




6 


8 




6 


9 


EOL 
sequence 



This nesting with parentheses is made with the same hierarchy as with parenthetical nesting 
within mathematical expressions. Only eight levels of nesting are allowed. 
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END with OUTPUTS that Use Images 

Using the optional secondary keyword END in an OUTPUT statement that uses an image 
produces results which differ from those of using END in a freefield OUTPUT statement. 
Instead of always suppressing the EOL sequence, the END keyword only suppresses the EOL 
sequence when no data are output from the last source-list expression. Thus, the "#" 
image specifier generally controls the suppression of the otherwise automatic EOL sequence, 
while the END keyword suppresses it only in less common usages. 

Examples 

Dei.Jice = 12 



OUTPUT Deuice USING " K " ! " ABC" »END 
OUTPUT Device USING "K " ; " ABC" iEND 
OUTPUT Device USING "K";"ABC" END 



A 


B 





EOL 
sequence 



The EOL sequence is not suppressed. 



OUTPUT Device USING " L . / » " "Li t e ral " " ♦>( »@" 



EOL 
sequence 


CR 


LF 


L 


i 


t 


e 


r 


a 


1 




FF 


EOL 
sequence 



In this case, specifiers that require no source-item expressions are used to generate characters 
for the output; there are no source expressions. The EOL sequence is output after all specifiers 
have been used to output their respective characters. Compare this action to that shown in the 
next example. 

OUTPUT Device USING " L » / » " " L i t e ra 1" " *K »i " 'END 



EOL 
sequence 


CR 


LF 


L 


i 


t 


e 


r 


a 


1 




FF 



The EOL sequence is suppressed because no source items were included in the statement; all 
characters output were the result of specifiers which require no corresponding expression in the 
source list. 

Additional Definition 

The END secondary keyword has been defined to produce additional action when included in 
an OUTPUT statement directed to HP-IB and Data Communications interfaces. 

END with HP-IB Interfaces 

With HP-IB interfaces, END has the additional function of sending the End-or-Identify signal 
(EOI) with the last character of either the last source item or the EOL sequence (if sent). As 
with freefield OUTPUT, no EOI is sent if no data is sent from the last source item and the 
EOL sequence is suppressed. 
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Examples 

ASSIGN @Deuice TO 701 

OUTPUT eDeuice USING " K " ? " Dat a " » END 
OUTPUT @Deuice USING "K";"Data"» 



D 


a 


t 


a 


EOL 
sequence 



EOl sent with last character 
of the EOL sequence. 

OUTPUT iDeuice USING "«»K";"Data" END 



D 


a 


t 


a 



EOl sent with this character. 



EOI is sent with the last character of the last source item when the EOL sequence is suppressed, 
because the last source item contained data which was used in the output. 



OUTPUT SDeuice USING " » f K " ; " Dat a " , " " tEND 
OUTPUT SDeuice USING Data 5END 



D 


a 


t 


a 



The EOI was not sent in either case, since no data were sent from the last source item and the 
EOL sequence was suppressed. 

END with Data Communications Interfaces 

With Data Communications interfaces, END has the additional definition of sending an end-of- 
data indication to the interface in the same instances in which EOI would be sent on HP-IB 
interfaces. See Chapter 13 for further details. 
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Chapter 



Introduction 

This chapter discusses the topic of entering data from devices. You may already be familiar 
with the OUTPUT statement described in the previous chapter; many of those concepts are 
applicable to the process of entering data. Earlier in this manual, you were told that the data 
output from the sender had to match that expected by the receiver. Because of the many 
ways that data can be represented in external devices, entering data can sometimes require 
more programming skill than outputting data. In this chapter, you will see what is involved in 
being the receiving device. Both free-field enters and enters that use images are described, 
and several examples are given with each topic. 



Free-Field Enters 

Executing the free-field form of the ENTER invokes conventions which are the "converse" of 
those used with the free-field OUTPUT statement. In other words, data output using the 
free-field form of the OUTPUT statement can be readily entered using the free-field ENTER 
statement; no explicit image specifiers are required. The following statements exemplify this 
form of the ENTER statement. 

Examples 

100 ENTER SMoltmete r ;Readin3 

100 ENTER 72a;ReadinS5(*) 

100 ENTER Fra(fl_5t ririS* ;Aue ra^e »StLiderit_natiie$ 

100 ENTER @Frorii_f i le ;Data_code »St r_ele(iierit$(X tY) 
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These first two statements are equivalent. 



Item Separators 

Destination items in ENTER statements can be separated by either a comma or a semicolon. 
Unlike the OUTPUT statement, it makes no difference which is used; data will be entered into 
each destination item in a manner independent of the punctuation separating the variables in 
the list. However, no trailing punctuation is allowed. The first two of the following statements 
are equivalent, but an error is reported when the third statement is executed. 

Examples 

ENTER @Frofti_a_dey ice ;N1 »N2 >N3- 

ENTER @Fro(ii_a_device ;N1 ;N2;N3- 

ENTER @From_a_dei.)ice iNl »N2 »N3 t -* Executing this statement causes an error. 

Item Terminators 

Unless the receiver knows exactly how many characters are to be sent, each data item output 
by the sender must be terminated by special character(s). When entering ASCII data' with the 
free-field form of the ENTER statement, the computer does not know how many characters 
will be output by the sender. 

Item terminators must signal the end of each item so that the computer enters data into the 
proper destination variable. The terminator of the last item may also terminate the ENTER 
statement (in some cases). The actual character(s) that terminate entry into each type of 
variable are described in the next sections. 

In addition to the termination characters, each item can be terminated (only with selected 
interfaces) by a device-dependent END indication. For instance, some interfaces use a signal 
known as EOl (End-or-Identify). The EOI signal is only available with the HP-IB, CRT, and 
keyboard interfaces. EOI termination is further described in the next sections. 

When using an I/O path that possesses the WORD attribute, an additional byte may be entered 
(but ignored). See Chapter 10 for further information. 

Entering Numeric Data 

When the free-field form of the ENTER statement is used, numbers are entered by a routine 
known as the "number builder". This firmware routine evaluates the incoming ASCII numeric 
characters and then "builds" the appropriate internal-representation number. This number 
builder routine recognizes whether data being entered is to be placed into an INTEGER or 
REAL variable and then generates the appropriate internal representation. 



1 The ASCII data representation described briefly in Chapter 2 is the default data representation used with devices; however, the internal 
representation can also be used. See "I/O Path Attributes" in Chapter 10 for further details. 
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The number builder is designed to be able to enter several formats of numeric data. However, 
the general format of numeric data must be as follows to be interpreted properly by the 
computer. 



Mantissa 
sign 


Mantissa 
digit(s) 


E 


Exponent 
sign 


Exponent 
digit(s) 


Terminator 

(character or 

END indication) 



Optional At least one Optional 

digit is required 



Required 



Numeric characters include decimal digits "0" through "9" and the characters ".", " + ", 
"-", "E", and "e". These last five characters must occur in meaningful positions in the data 
stream to be considered numeric characters; if any of them occurs in a position in which it 
cannot be considered part of the number, it will be treated as a non-numeric character. 

The following rules are used by the number builder to construct numbers from incoming 
streams of ASCII numeric characters. 

1. All leading non-numerics are ignored; all leading and imbedded spaces are ignored. 

Example 

100 ASSIGN iDeuice TO Deu i ce.s e 1 ec t o r 

110 ENTER eOevice ;Numbe r ! Default is data type REAL. 

120 END 



Ignored 



Consumed 



N 


u 


m 


b 


e 


r 


= 






1 


2 




3 


LF 



Number Terminator (for both 

item and statement) 



The result of entering the preceding data with the given ENTER statement is that Num- 
ber receives a value of 123. The line-feed (statement terminator) is required since 
Number is the last item in the destination list. 
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2. Trailing non-numerics terminate entry into a numeric: variable, and the terminating char- 
acters (of both string and numeric items) are "consumed". In this manual, "consumed" 
characters refers to characters used to terminate an item but not entered into the variabl- 
e; "ignored" characters are entered but are not used. 

Example 

ENTER @Deu ice iReal-riuwbe r tSl rin S* 

Consumed Consumed 





























r "1 










N 


u 


m 


b 


e 


r 


= 




1 


2 


3 




4 


A 


B 


C 


D 


LF (or CR/LF) 



Ignored ReaLnumber Numeric String$ Terminator (for both 

item terminator item and statement) 

The result of entering the preceding data with the given ENTER statement is that ReaL 
number receives the value 123.4 and String$ receives the characters "BCD". The "A" 
was lost when it terminated the numeric item; the string-item terminator(s) are also lost. 
The string-item terminator(s) also terminate the ENTER statement, since String$ is the 
last item in the destination list. 

3. If more than 16 digits are received, only the first 16 are used as significant digits. 
However, all additional digits are treated as trailing zeros so that the exponent is built 
correctly. 

Example 

ENTER iDeuice jReal-riumbe r_l 

Consumed 



1 


2 


3 


4 


5 


6 


7 


8 


9 





1 


2 


3 


4 


5 


6 


LF 



ReaLnumber_1 Terminator (for botti 

item and statement) 



The result of entering the preceding data with the given ENTER statement is that ReaL 
number_l receives the value 1.234567890123456 E + 15. 



Example 



ENTER @Dei.' ice 5Real_riLifflbG r_2 
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Used only to build 

the exponent. Consumed 



1 


2 


3 


4 


5 


6 


7 


8 


9 





1 


2 


3 


4 


5 


6 


7 


8 


LF 





ReaLnumber_2 



Terminator (for both 
item and statement) 



The result of entering the preceding data with the given ENTER statement is that ReaL 
number_2 receives the value 1.234567890123456 E + 17. 

4. Any exponent sent by the source must be preceded by at least one mantissa digit and 
an "E" (or "e") character. If no exponent digits follow the "E" (or "e"), no exponent 
is recognized, but the number is built accordingly. 

Example 

ENTER @De u ice 5Real_ number 



Consumed 



E 




8 


. 


8 


5 




E 


- 


1 


2 


C 





u 


1 


LF 



Ignored 



Real-number Numeric Ignored Terminator 

item terminator 



The result of entering the preceding data with the given ENTER statement is that Real- 
number receives a value of 8.85 E- 12. The character "C" terminates entry into Real- 
number, and the characters "oul" are entered (but ignored) in search of the required 
line-feed statement terminator. If the character "C" is to be entered but not ignored, 
you must use an image. Using images with the ENTER statement is described later in 
this chapter. 
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5. If a number evaluates to a value outside the range corresponding to the type of the 
numeric variable, an error is reported. If no type has been declared explicitly for the 
numeric variable, it is assumed to be REAL. 

Example 

ENTER @DeM ice ;Real_nuwbe r 

Consumed 

Evaluates to 1 ,234 E + 309. 



1 


2 


3 




4 


E 


+ 


3 





7 


LF 





The resultant value cannot Terminator (for both Items 

be stored in ReaLnumber. and statement) 

The data is entered but evaluates to a number outside the range of REAL numbers. 
Consequently, error 19 is reported, and the variable Real_number retains its former 
value. 

6. If the item is the last one in the list, both the item and the statement need to be properly 
terminated. If the numeric item is terminated by a non-numeric character, the state- 
ment will not be terminated until it either receives a line-feed character or an END 
indication (such as EOI signal with a character). The topic of terminating free-field EN- 
TER statements is described later in this chapter in the section of the same name. 

Entering String Data 

Strings are groups of ASCII characters of varying lengths. Unlike numbers, almost any charac- 
ter can appear in any position within a string; there is not really any defined structure of string 
data. The routine used to enter string data is therefore much simpler than the number builder. 
It only needs to keep track of the dimensioned length of the string variable and look for 
string-item terminators (such as CR/LF, LF, or EOI sent with a character). 

String-item terminator characters are either a line-feed (LF) or a carriage-return followed by a 
line-feed (CR/LF). As with numeric-item terminators characters, these characters are not en- 
tered into the string variable (during free-field enters); they are "lost" when they terminate 
the entry. The EOI signal also terminates entry into a string variable, but the variable must be 
the last item in the destination list (during free-field enters). 

All characters received from the source are entered directly into the appropriate string vari- 
able until any of the following conditions occurs: 

• an item terminator character is received. 

• the number of characters entered equals the dimensioned length of the string variable. 

• the EOI signal is received. 

The following statements and resultant variable contents illustrate the first two conditions; the 
next section describes termination by EOI. Assume that the string variables Five_char$ and 
Ten_char$ are dimensioned to lengths of 5 and 10 characters, respectively. 
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Example 



ENTER @De y i ce iFi i.je_cha r$ 



Consumed 





















/— ^'"> 


A 


B 


C 


D 


E 


F 


G 


H 


CR 


LF 














^. 



Five_char$ Ignored Terminator (for both 

item and statement) 



The variable Five_char$ only receives the characters "ABCDE", but the ebaracters "FGH" 
are entered (and ignored) in search of the terminating carriage-return/line-feed (or line-feed). 

Example 

ENTER @Deu i ce ;Ten_cha r$ 



Consumed 



A 


B 


C 


D 


E 


F 


G 


LF 





or 



Ten_char$ 



Terminator (for 

both item and statement) 



Consumed 



A 


B 


C 


D 


E 


F 


G 


CR 


LF 


, 












J, 



Ten_char$ 



Terminator (for both 
item and statement) 



The result of entering the preceding data with the given ENTER statement is that Ten_char$ 
receives the characters "ABCDEFG" and the terminating LF (or CR/LF) is lost. 
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Terminating Free-Field ENTER Statements 

Terminating conditions for free-field ENTER statements are as follows. 

1. If the last item is terminated by a line-feed or by a character accompanied by EOI, the 
entire statement is properly terminated. 

2. If an END indication is received while entering data into the last item, the statement is 
properly terminated. Examples of END indications are encountering the last character of 
a string variable while entering data from the variable, receiving EOI with a character, 
and receiving a control block while entering data through the Data Communications 
interface. 

3 If one of the preceding statement-termination conditions has not occurred but entry 
into the last item has been terminated, up to 256 additional characters are entered in 
search of a termination condition. If one is not found, an error occurs. 

One case in which this termination condition may not be obvious can occur while entering 
string data. If the last variable in the destination list is a string and the dimensioned length of 
the string has been reached before a termination condition occurs, additional characters are 
enterd (but ignored) until a termination condition occurs. The reason for this action is that the 
next characters received are still part of this data item, as far as the data sender is concerned. 
These characters are accepted from the sender so that the next enter operation will not receive 
these "leftover" characters. 

Another case Involving numeric data can also occur (see the example given with "rule 4" 
describing the number builder). If a trailing non-numeric character terminates the last item 
(which is a numeric variable), additional characters will be entered in search of either a line- 
feed, an end-of-data, or a character accompanied by EOI. Unless a terminating condition is 
found before 256 characters have been entered, an error is reported. 

EOI Termination 

A termination condition for the HP-IB Interface is the EOI (End-or-Identify) signal. When this 
message is sent, it immediately terminates the entire ENTER statement, regardless of whether 
or not all variables have been satisfied. However, if all variable items in the destination list 
have not been satisfied, an error is reported. 

Example 

ENTER @Deu ice ;St ririiS$ 



A 


B 


C 


D 


E 


F 



or 



A 


B 


C 


D 


E 


F 


LF 



or 



A 


B 


C 


D 


E 


F 


CR 


LF 



Sent with 
EOI 



Sent with 
EOI 



Sent with 
EOI 



The result of entering the preceding data with the given ENTER statement is that String$ 
receives the characters "ABCDEF". The EOI signal being received with either the last charac- 
ter or with the terminator character properly terminates the ENTER statement. If the character 
accompanied by EOI is a string character (not a terminator), it is entered into the variable as 
usual. 
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Example 



ENTER iDeu ice iNuriibe r 
Used to build Number 










Consumed 


or 










Consumed 


1 


2 


3 


4 


5 


or 


1 


2 


3 


4 


5 


A 




1 


2 


3 


4 


5 


LF 






Kith 








vith 

1 










N 


umb 


3r S 


ent V 
EO 




Number 


Sentv 
EO 




Number 


Sent with 
EOl 



The result of entering any of the above data streams with the given ENTER statement is that 
Number receives the value 12345. If the EOl signal accompanies a numeric character, it is 
entered and used to build the number; if the EOl is received with a numeric terminator, the 
terminator is lost as usual. 

Example 

ENTER @Dey i ce jNumbe r fSt r in S$ 



An error Is reported 

(Error 153 Insufficient data for ENTER). 



1 


2 


3 


4 


5 



Number Sent with 
EOl 

The result of entering the preceding data with the given statement is that an error is reported 
when the character "5" accompanied by EOl is received. However, Number receives the 
value 12345, but String$ retains its previous value. An error is reported because all variables 
in the destination list have not been satisfied when the EOl is received. Thus, the EOl signal is 
an immediate statement terminator during free-field enters. The EOl signal has a different 
definition during enters that use images, as described later in this chapter. 



The EOl signal is implemented on the HP-IB Interface, described in Chapter 11 of this manu- 
al. Since it is often convenient to to use the keyboard and CRT for external devices, these 
internal devices have been designed to simulate this signal. Further descriptions of this fea- 
ture's implementation in the keyboard and CRT are contained in Chapters 8 and 9 of this 
manual, respectively. 
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Enters that Use Images 



The free-field form of the ENTER statement is very convenient to use; the computer automati- 
cally takes care of placing each character into the proper destination item. However, there are 
times when you need to design your own images that match the format of the data output by 
sources. Several instances for which you may need to use this type of enter operations are: 
the incoming data does not contain any terminators; the data stream is not followed by an 
end-of-line sequence; or two consecutive bytes of data are to be entered and interpreted as a 
two's-complement integer. 

The ENTER USING Statement 

The means by which you can specify how the computer will interpret the incoming data is to 
reference an image in the ENTER statement. The four general ways to reference the image in 
ENTER statements are as follows. 

1. 100 ENTER @Dei.)ice_x USING " GA *DDD , DD " ; St r i n S_m a r$ »Num_M a r 

2. 100 Irna^e.st r$="BA tDDD.DD" 

110 ENTER 8Dei.Jice_x USING I ma 3e_s t r$ 5 S t r i n 3_u a r$ tNu(Ti_u a r 

3. 100 ENTER @Dei.Jice USING I ma 3e_s tmt 5 St r i n tf_u a r$ »Nu(ii_u a r 
110 I(TiaSe_stmt : IMAGE GA>DDD.DD 

4. 100 ENTER iDeuice USING 1 1 i St r i n S_u a r$ »Nurn_y a r 
110 IMAGE BA»DDD.DD 



Images 

Images are used to specify how data entered from the source is to be interpreted and placed 
into variables; each image consists of one or more groups of individual image specifiers that 
determine how the computer will interpret the incoming data bytes (or words). Thus, image 
lists can be thought of as either a format description of the expected data or as a procedure 
that the ENTER statement will use to enter and interpret the incoming data bytes. The exam- 
ples given here treat the image list as a procedure. 

All of the image specifiers used in image lists are valid for both enters and outputs. However, 
most of the specifiers have a slightly different meaning for each operation. If you plan to use 
the same image for output and enter, you must fully understand how both statements will use 
the image. 

Example of an Enter Using an Image 

This example is used to show you exactly how the computer uses the image to enter incoming 
data into variables. Look through the example to get a general feel for how these enter 
operations work. Afterwards, you should read the descriptions of the pertinent specifier(s). 
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Assume that the following stream of data bytes are to be entered into the computer. 



T 


e 


m 


P 


, 


= 






+ 


9 


8 


, 


3 




F 


a 


h 


r 


e 


n 


h 


e 


t 




ii .. 



Ignored Degrees UnitsS Ignored f 

Assume EOl is sent — ' 
with this character 



Given the above conditions, let's look at how the computer executes the following ENTER 
statement that uses the specified IMAGE statement. 

300 ENTER @Deyice USING I(iia^e_l JDe ^ rees fUn i t s$ 
310 ImaSe_l: IMAGE 8X.SDDD.D»A 

Step 1. The computer evaluates the first image of the IMAGE statement. It is a special image 
in that it does not correspond to a variable in the destination list. It specifies that 
eight characters of the incoming data stream are to be ignored. Eight characters, 
"Temp. = ", are entered and are ignored (i.e., are not entered into any variable). 

Step 2. The computer evaluates the next image. It specifies that the next six characters are 
to be used to build a number. Even though the order of the sign, digit, and radix are 
explicitly stated in the image, the actual order of these characters in the incoming 
data stream does not have to match this specifier exactly. Only the number of 
numeric specifiers in the image, here six, is all that is used to specify the data for- 
mat. When all six characters have been entered, the number builder attempts to 
form a number. 

Step 3. After the number is built, it is placed into the variable "Degrees"; the representation 
of the resultant number depends on the variable's type (REAL or INTEGER). 

Step 4. The next image in the IMAGE statement is evaluated. It requires that one character 
be entered for the purpose of filling the variable "Units$". One byte is then entered 
into UnitsS. 

Step 5. All images have been satisfied; however, the computer has not yet detected a state- 
ment-terminating condition. A line-feed or a character accompanied by EOI must be 
received to terminate the ENTER statement. Characters are then entered, but 
ignored, in search of one of these conditions. The statement is terminated when the 
EOI is sent with the "t". For further explanation, see "Terminating Enters that Use 
Images", near the end of this chapter. 

The above example should help you to understand how images are used to determine the 
interpretation of incoming data. The next section will help you to use each specifier to create 
your desired images. 
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Image Definitions During Enter 

This section describes the individual image specifiers in detail. The specifiers have been 
categorized into data and function type. 

Numeric Images 

Digit, sign, radix, and exponent specifiers are all used identically in enter images. The number 
builder can also be used to enter numeric data. 



Image 
Specifier 



Numeric Specifiers 

Meaning 



D 

Z, * 

S, M 



R 



ESZ 
ESZZ 
ESZZZ 
K, -K 

H, -H 



Specifies that one byte is to be entered and interpreted as a numeric charac- 
ter. If the character is non-numeric (including leading spaces and item 
terminators), it will still "consume" one digit of the image item. 

Same action as D. Keep in mind that Z and * can only appear to the left of 
the radix indicator (decimal point or R) in a numeric image item. 

Same action as D in that one byte is to be entered and interpreted as a 
numeric character. At least one digit specifier must follow either of these 
specifiers in an image item. 

Same action as D in that one byte is to be entered and interpreted as a 
numeric character. At least one digit must accompany this specifier in the 
image item. 

Same action as D in that one byte is to be entered and interpreted as a 
numeric character; however, when R is used in a numeric image, it directs 
the number builder to use the comma as a radix indicator and the period as 
a terminator for the numeric item. At leeist one digit specifier must accom- 
pany this specifier in the image item. 

Equivalent to 4D, if preceded by at least one digit specifier (Z, *, or D) in the 
image item. The following specifiers must also be preceded by at least one 
digit specifier. 

Equivalent to 3D. 

Equivalent to 4D. 

Equivalent to 5D. 

Specifies that a variable number of characters are to be entered and inter- 
preted according to the rules of the number builder. 

Like K, except that a comma is used as the radix indicator, and a period is 
used as a terminator for the numeric item. 



Examples of Numeric Images 



ENTER iDevice USING " SDD . D" 5 Numb e r 

ENTER eOeuice USING " 3D ♦ D" SNumbe r 

ENTER UDeuice USING "5D" ;Nufiibe r 

ENTER @Deuice USING " DESZZ " > Numb e r 

ENTER iDeuice USING " ** . DD " iNumh e r 



These five images 
are equivalent. 
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ENTER iDeuice USING "K";Number 
ENTER iDeuice USING "DDRDD" JNumbe r 
ENTER iDeuice USING "H";NufTiber 



Use the rules of the number builder. 

Enter five characters, 
using comma as radix. 

Use the rules of the number builder, 
but use the comma as radix and 
period as terminator. 



String Images 

The following specifiers are used to determine the number of and the interpretation of data 
bytes entered into string variables. 



String Specifiers 



Image 
Specifier 



A 
K, H 

-K, -H 



L, 



Meaning 



Specifies that one byte is to be entered and interpreted as a string character. 
Any terminators are entered into the string when this specifier is used. 

Specifies that string-freefield convention is to be used to enter data into a 
string variable; characters are entered directly into the variable until a termi- 
nating condition is received (CR/LF, LF, or an END indication). 

Like K, except that line-feeds do not terminate entry into the string; instead, 
they are treated as string characters and placed in the variable. Receiving an 
END indication (for instance, receiving EOI with a character, encountering 
an end-of-data, or reaching the string variable's dimensioned length) ter- 
minates the image item. 

These specifiers are ignored for ENTER operations; however, they are 
allowed for compatibility so that an image can be referenced by both EN- 
TER and OUTPUT statements. Note that it may be necessary to skip char- 
acters (with specifiers such as "X" or "/") when ENTERing data which has 
been sent by including these specifiers in an OUTPUT statement. Even 
greater care must be given to cases in which pad bytes may be sent; see 
"The BYTE and WORD Attributes" in Chapter 10 for further explanation. 



Examples of String Images 



ENTER SDeuice USING " lOA" ;Ten_cha rs* 



Enter 1 characters. 



ENTER iDeuice USING "K " 5 Any_5t rin S$ Enter using the free-field rules. 

ENTER @Deyice USING "5A »K " 5St ri n ^$ »NufTibe r$ Enter two strings. 
ENTER @Deyice USING "5A »K " ;St r in S$ »Nutttbe r Enter a string and a number. 



ENTER iDeuice USING " -K " i Al l_cha rs$ 



Enter all characters until the 
string is "full" or END is received. 
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Ignoring Characters 

These specifiers are used when one or more characters are to be ignored (i.e., entered but not 
placed into a string variable). 

Specifiers Used to Ignore Characters 



Image 
Specifier 


Meaning 


X 


Specifies that a character is to be entered and ignored. 


"literal" 


Specifies that the number of characters in the literal are to be entered and 
ignored. 


/ 


Specifies that all characters are to be ignored (i.e., entered but not used) 
until a line-feed is received. EOl is also ignored until the line-feed is re- 
ceived. 



Ignore first five and use 
second five characters. 



Examples of Ignoring Characters 

ENTER @Deuice USING " 5X »5A " ! F i u e_c h a r5$ 
ENTER @DeMice USING " 5A »4X 1 1 OA " ; S_ 1 $ »S_2$ Ignore 6th through 9th characters. 
ENTER iDeuice USING " / »K " 5 St r i n ?2$ Ignore 1st item of unknown length. 

ENTER SDeuice USING " " " Z Z " " , AA " ; S_2$ Ignore two characters. 
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Binary Images 

These specifiers are used to enter one byte (or word) that will be interpreted as a number. 



Image 
Specifier 



Binary Specifiers 

Meaning 



B 



W 



Y 



Specifies that one byte is to be entered and and interpreted as an integer in 
the range of through 255. 

Specifies that one 16-bit word is to be entered and interpreted as a 16-bit, 
two's-complement integer. If either an I/O path name with the BYTE attri- 
bute (see Chapter 10) or a device selector is used to access an 8-bit inter- 
face, two bytes will be entered; the first byte entered is most significant. If an 
I/O path name with the BYTE attribute is used to access a 16-bit interface, 
the BYTE attribute is overridden and one word is entered in a single opera- 
tion. If an I/O path name with the WORD attribute is used to access a 16-bit 
interface, one byte is entered and ignored when necessary to achieve align- 
ment on a word boundary. If the source is a file, string variable, or buffer, 
the WORD attribute is ignored and all data are entered as bytes; however, 
one byte may still be entered and ignored when necessary to achieve 
alignment on a word boundary. 

Like W, except that pad bytes are never entered to achieve word alignment. 
If an I/O path name with the BYTE attribute is used to access a 16-bit 
interface, the BYTE attribute is not overridden (as with the W specifier). 



Examples of Binary Images 

ENTER @Deuice USING "B ,B »B" !N1 »N2 >N3 

ENTER iDeuice USING "W»K";N»N$ 
Assume that ©Device possesses the WORD attribute. 

ENTER SDevice USING " B » W" i Num. 1 >Num_2 
©Device may possess either BYTE or WORD attribute. 

ENTER @Deuice USING "B »Y " ! Num_l »Nurit_2 



Enter three bytes, then look 
for LF or END indication. 

Enter the first two bytes as an INTEGER, 
then the rest as string data. 



Enter one byte, ignore one (pad) 

byte, enter one word, then search for terminator. 



Enter one byte, enter one word, 
then search for terminator. 
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Terminating Enters that Use Images 

This section describes the default statement-termination conditions for enters that use im- 
ages (for devices). The effects of numeric-item and string-item terminators and the EOI signal 
during these operations are discussed in this section. After reading this section, you will be able 
to better understand how enters that use images work and how the default statement- 
termination conditions are modified by the », 1, +, and - image specifiers. 

Default Termination Conditions 

The default statement-termination conditions for enters that use images are very similar to 
those required to terminate free-field enters. Either of the following conditions will properly 
terminate an ENTER statement that uses an image. 

1. An END indication (such as the EOI signal or end-of-data) is received with the byte that 
satisfies the last image item or within 256 bytes after the byte that satisfied the last 
image item. 

2. A line-feed is received as the byte that satisfies the last image item (exceptions are the 
"B" and "W" specifiers) or within 256 bytes after the byte that satisfied the last image 
item. 

EOI Re-Definition 

It is important to realize that when an enter uses an image (when the secondary keyword 
"USING" is specified), the definition of the EOI signal is automatically modified. If the EOI 
signal terminates the last image item, the entire statement is properiy terminated, as with 
free-field enters. In addition, multiple EOI signals are now allowed and act as item termina- 
tors; however, the EOI must be received with the byte that satisfies each image item. If the 
EOI is received before any image is satisfied, it is ignored. Thus, all images must be satisfied, 
and EOI will not cause eariy termination of the ENTER-USING-image statement. 

The following table summarizes the definitions of EOI during several types of ENTER state- 
ment. The statement-terminator modifiers are more fully described in the next section. 

Definition of EOI During ENTER Statements 





Free-field 


ENTER statements that use an image: 




ENTER 
statements 










without 










''»" or "Z" 


with "»'■ 


with '"Z" 


Definition 


Innmediate 


Item 


Item 


Immediate 


of EOI 


statement 


terminator 


terminator 


statement 




terminator 


or statement 
terminator 


or statement 
terminator 


terminator 


Statement 










terminator 


Yes 


Yes 


No 


No 


required? 










Early 










termination 


No 


No 


No 


Yes 


allowed? 
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Statement-Termination Modifiers 

These specifiers modify the conditions that terminate enters that use images. The first one of 
these specifiers encountered in the image list modifies the termination conditions for the EN- 
TER statement. If another of these specifiers is encountered in the image list, it again modifies 
the terminating conditions for the statement. 



Image 
Specifier 



Statement-Termination Modifiers 



Meaning 



+ 



Specifies that a statement-termination condition is not required; the EN- 
TER statement is automatically terminated as soon as the last image item 
is satisfied. 

Also specifies that a statement-termination condition is not required. In 
addition, EOl is re-defined to be an immediate statement terminator, 
allowing early termination of the ENTER before all image items have 
been satisfied. However, the statement can only be terminated on a "legal 
item boundary". The legal boundaries for different specifiers are as follows. 

Specifier Legal Boundary 

K, - K With any character, since this specifies a variable-width field 

of characters. 

S,M,D,E Only with the last character that satisfies the image (e.g., 

Z,.,A,X with the 5th character of a "5A" image). If EOl is received 

"lit" with any other character, it is ignored. 
B,W 

/ Only with the last line-feed character that satisfies the image 

(e.g., with the 3rd line-feed of a "3/" image); otherwise it is 
ignored. 

Specifies that an END indication is required to terminate the ENTER state- 
ment. Line-feeds are ignored as statement terminators; however, they will 
still terminate items (unless a - K or - H image is used for strings). 

Specifies that a line-feed is required to terminate the statement. EOl is 
ignored, and other END indications (such as EOF or end-of-data) cause an 
error if encountered before the line-feed. 
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Examples of Modifying Termination Conditions 

ENTER @Deuice USING "«>B";Byte Enter a single byte. 

ENTER iDeuice USING " « * W " ; I n t e Se r Enter a single word. 

ENTER @Dei.'ice USING "ZjK";Array(*) Enter an array, allowing early termination by EOl. 

Enter characters into Strings 

ENTER iDeuice USING " + ,K " ; St r i n 9$ T ne-'eed received 

then continue entering characters 
until END received. 

Enter characters until 
ENTER SDeuice USING " - >K " ? S t r i n S$ line-feed received; ignore 

EOl, if received. 



Additional Image Features 



Several additional image features are available with the computer. Some of these features have 
already been shown in examples, and all of them resemble the additional features of images 
used with OUTPUT statements. 

Repeat Factors 

All of the following specifiers can be preceded by an integer that specifies how many times the 
specifier is to be used. 

Repeatable Specifiers 

D, Z, A, X, /,(a,L 

Image Re-Use 

If there are fewer images than items in the destination list, the list will be re-used, beginning 
with the first item in the image list. If there are more images than there are items, the addition- 
al specifiers will be ignored. 

Examples 

ENTER iDeuice USING " « ,B " ? B 1 »B2 »B3 The "B" is re-used. 

ENTER iDeuice USING " 2A j2A » W " 5 A$ jB$ The W" is not used. 

Nested Images 

Parentheses can be used to nest images within the image list. The hierarchy is the same as 
with mathematical operations; evaluation is from inner to outer sets of parentheses. The max- 
imum number of levels of nesting is eight. 

Example 

ENTER iSource USING " 2 ( B ,5A ,/),/"; N 1 ,N 1 $ ,N2 ,N2$ 
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Chapter 

Registers 



Introduction 

A register is a memory location. Thus, some registers store parameters that describe the 
operation of an interface, some store information describing the I/O path to a device, and some 
are the locations at which interface cards reside (remember that the computer implements 
"memory-mapped I/O"). 

Registers are accessed by the computer when executing I/O statements that specify either an 
interface select code, a device selector, or an I/O path name. Thus, each interface and I/O 
path has its own set of registers. The general programming techniques used to access these 
registers and the specific definitions of all I/O path registers are given in this chapter; 
however, the specific definitions of the interface registers are given in the chapter that de- 
scribes each interface. 

There are three levels of register access. The first level of access is automatically made by 
the computer when an I/O statement is executed. The second level of access (provided by the 
STATUS and CONTROL statements) allows interrogating and changing interface and I/O 
path registers. The third level of access (provided by the READIO function and the WRITEIO 
statement) is used to read from and write to interface hardware directly. 
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Interface Registers 

A simple example of an interface register being accessed explicitly by the program and then 
automatically by I/O statements is shown in the following program. Register of interface 
select code 1 is the "X" screen coordinate at which subsequent characters output to the the 
CRT will begin being displayed; register 1 is the corresponding "Y" coordinate. 

100 STATUS 1 ;Re3_0 tRe3_l ! Psrm accessing X &: Y coords. 

110 OUTPUT ir'Print coordinates before Ist OUTPUT:" 

120 OUTPUT 1 ; "X=" ;Re3_0 »" Y = ";Re3_l 

130 OUTPUT 1 

lao ! 

150 OUTPUT i;"123a5G7"; ! Note 'T'. 

ISO STATUS 1 ;ReS_0 .ReS-l 

170 OUTPUT 1 

180 OUTPUT i;"Print coordinates after OUTPUTs:" 

190 OUTPUT 1 ;"X=" ;ReS_0 ," Y = ";Re^_l 

200 OUTPUT 1?" " 

210 ! 

220 END 

The STATUS Statement 

The contents of a STATUS register can be read with the STATUS statement. Typical exam- 
ples are shown below. A complete listing of each interface's registers is given in the chapter 
that describes programming each interface; the definitions of I/O path registers are described 
later in this chapter. 

Example 

STATUS register 7 of the interface at select code 2 is read with the following statement. The 
first parameter identifies the interface and the optional second parameter identifies which 
register is to be read. The specified numeric variable receives the register's current contents. 



• Interface select code 

/ 

STATUS 2»7;ReS_7 

/ \ 

Register number Numeric variable(s) to 

(optional) receive reglster(s) contents 



Example 

I/O path STATUS register is read with the following statement. Since the second parameter 
is optional and has been omitted in this instance, register is accessed. 

STATUS SKeyboard ;Re3_0 
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Example 

STATUS registers 4 and 5 of the interface at select code 7 are read with the following state- 
ment. Since two numeric variables are to receive register contents, the next highest register is 
accessed. If more than two variables are specified, successive registers are read. 

100 STATUS 7 »a5Re3_a »ReS_5 

The CONTROL Statement 

When some I/O statements are executed, the contents of some CONTROL registers are auto- 
matically changed. For instance, in the above example registers and 1 were changed 
whenever the OUTPUT statements to the CRT were executed. The program can also change 
some register's contents with the CONTROL statement, as shown in the following examples. 
Again, all of the CONTROL register definitions for each interface are given in the chapter that 
describes programming each interface. 

Example 

Register of interface select code 1 is modified with the following statement. This register 
determines the "X" screen coordinate at which subsequent characters output to the CRT 
display will appear. 

, Interface select code 
100 CONTROL i;X_POS 



\ 



Numeric expression(s) to be sent 
to the appropriate register(s) 



Example 

Register 1 of interface select code 1 is modified with the following statement. This register's 
contents determine the "Y" coordinate at which subsequent characters' output to the screen 
appear. 



100 CONTROL 1 tl ;Line_Pos 

Register number 



J. 1 i_ 
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I/O Path Registers 

At this point you know how to access the registers associated with interfaces and I/O path 
names, but you may not know much about the differences or about the interaction between 
these two types of registers. Let's first review the definition of an I/O path name. 

An I/O path name is a data type that contains a description of an I/O path between the 
computer and one of its resources sufficient to allow accessing the resource. You learned in 
Chapter 3 that the computer uses this information whenever the I/O path name is used in an 
I/O statement. Much of this information stored in this I/0-path-name table can be accessed 
with the STATUS and CONTROL statements. 

When an I/O path name is used to specify a resource in an I/O statement, the computer 
accesses the first table entry (the validity flag) to see if the name is currently assigned. If the 
I/O path name is assigned, the computer reads I/O path register which tells the computer the 
type of resource involved. If the resource is a device, the computer must also access the 
registers of the interface specified by the device selector. If the resource is a file, the table 
contains additional entries that govern how the I/O process is to be executed. 

As you can see, the set of I/O path registers is not the same set of registers associated with an 
interface. The following program is an example of using I/O path register to determine the 
type of resource to which the I/O path name has been assigned. 

700 Find_tv'pe: STATUS @Resou re e iRe S_0 

710 ! 

720 IF Re^_0 = THEN GOTO No t,_as s i Sn e d 

730 ! 

740 IF Re^_0=l THEN GOTO Dei.iice 

750 ! 

7G0 IF ReH(_0 = 2 THEN GOTO File 

770 ! 

780 PRINT "Resource type un re c o Sn i zed " 

790 PRINT "Prosram STOPPED," 

800 STOP 

810 ! 

820 No t_ass i 3n ed : PRINT "I/O path name not assigned" 

830 GOTO Co(tifflon_eK i t 

Bao ! 

850 Deuice: STATUS @Re sou rce » 1 ;Re 3_1 

8G0 PRINT "iResource assigned to deuice" 

870 PRINT "at intf* select code ";ReS_l 

880 GOTO Common-exit 

890 ! 

900 ! 

910 File: STATUS ©Re so u re e . 1 5 Re 3_1 .Re 3.-2 »Re s(_3 

920 ! 
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930 


PRINT 


940 


PRINT 


950 


PRINT 


9G0 


! 


970 


! 


980 


Common_exit 



"File type ";Re^_l 

"Device selector ";Re^_2 
"Number of sectors ";Re^_3 



! Exit point of this routinei 



Once the type of resource has been determined, it can be further accessed with the I/O path 
registers or the interface registers, depending on the resource type. If the I/O path name has 
been assigned to a device, the interface registers should be accessed for further information; 
if the name has been assigned to a mass storage file, the I/O path registers should be 
accessed. 

I/O path names can be assigned to device selectors, files, and buffers. The following program 
shows an example of determining the interface select code of the resource to which the I/O path 
name has been assigned. 



Example of determininS select code 

to which an I/O path name is assigned. 



100 

110 

120 

130 Show_sc: IMAGE "'@Io_path' assiSned to "rK."i Select code = " .D .L 

140 ! 

150 ASSIGN l?Io_path TO 701 ! Device selector. 

160 Deuice_5elector=FNSc(@Io_path) 

170 OUTPUT 1 USING Show_sc i " de u i c e 701 " iDeu i ce_5e 1 ec t o r 

180 ! 

190 ASSIGN @Io_path TO "Datal" ! ASCII file. 

200 Device_selector=FNSc(@Io_path) 

210 OUTPUT 1 USING Show_sc i " ASCI I f i 1 e " .De u i ce_se 1 ec t o r 

220 ! 

230 ASSIGN eio-path TO "Chapl" ! BOAT file. 

240 Dei.iice_selectar = FNSc(@Io_path) 

250 OUTPUT 1 USING She w_sc i "BOAT f i 1 e " .Deu i ce_se 1 e c t o r 

260 ! 

270 ASSIGN Blo-path TO BUFFER [1024] ! Buffer. 

2B0 Deuioe_seleotor=FNSc(eio_path) 

290 OUTPUT 1 USING Show_5 c i "BUFFER " .Deu i ce_se 1 e c to r 

300 ! 

310 END 

320 ! 

330 DEF FNSc (eio_path ) ! ************************************* 

340 ! Read I/O path resister 0. 

350 STATUS ei o_pat h iRe sou rce_c o de 

360 SELECT Reso u rce_co de 

370 CASE ! Not assigned. 

380 RETURN -1 ! Return a select code out of ranSe. 

390 CASE 1 ! AssiSned to a device selector. 

400 STATUS @Io_path .1 iSelect_code 

410 RETURN Select-code 

420 CASE 2 ! Assigned to a file specifier. 

430 STATUS @I O-Path t2 !De w i o e_s e 1 eo t o r 

440 WHILE Deyice_selector>100 

450 Dey i ce_se 1 eoto r = Deu i ce_se lecto r/ 100 ! Remove addresses. 

460 END WHILE 

470 RETURN Device-selector 

480 CASE 3 ! Assigned to a buffer. 

490 RETURN ! No errori but cannot determine source 

500 ! or destination of transfer to/from buffer. 

510 END SELECT 

520 ! 

530 FNEND ! ♦«*#»#«»»###»*♦***#*♦#♦«#*»**»♦*■»»»**»**♦♦**#»♦» 
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The following printout shows a typical example of the program's output. 

'@lD_path' assiSned to deuice 701! Select code = 7 

'@Io__path' assisned to ASCII file! Select code = a 

'@Io_path' assiined to BOAT file! Select code = a 

'@Io_path' assiSned to BUFFER! Select code = 

The user-defined function called FNSc interrogates 1/0 path registers to find the select code. If 
the 1/0 path name is currently not assigned, the function returns an arbitrary value of - 1 (an 
invalid value of select code). Since STATUS Register 2 of I/O path names assigned to files 
contains the entire device selector, which may include addressing information, the function 
must remove any addressing information to extract the select code. 

Notice that buffers have no select code associated with them, since they are a data type resident 
in computer memory; thus the function returns a value of 0. 

With AP2.0, this function is a feature of the BASIC language system. The following statements 
show examples of using this function. 

Select_code=SC(@lQ_path) 

IF SC(@File)=4 THEN De m i c e_ t v pe$= " I NTERNAL " 

The only difference in this language-resident function and the preceding example is that the SC 
function reports an error if the I/O path specified as its argument is not assigned, rather than 
returning a select code out of range. 
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Interface Registers 



I/O Path Status and Control Registers 

For All I/O Path Names: 



Returned 
Value 



Status Register 




1 
2 
3 



Meaning 



Invalid I/O path name 
I/O path name assigned to a device 
I/O path name assigned to a data file 
I/O path name assigned to a buffer 



I/O Path Names Assigned to a Device: 

Status Register 1 Interface select code 



Status Register 2 
Status Register 3 



Number of devices 
1st device selector 



If assigned to more than one device, the other device selectors are available starting in Status 
Register 4. 

I/O Path Names Assigned to an ASCII File: 



Status Register 1 
Status Register 2 
Status Register 3 
Status Register 4 
Status Register 5 
Status Register 6 

I/O Path Names Assigned 
Status Register 1 
Status Register 2 
Status Register 3 
Status Register 4 
Status Register 5 



File type = 3 

Device selector of mass storage device 

Number of records 

Bytes per record = 256 

Current record 

Current byte within record 

to a BDAT File: 

File type = 2 

Device selector of mass storage device 
Number of defined records 
Defined record length (in bytes) 
Current record 



Control Register 5 Set current record 



Status Register 6 
Control Register 6 

Status Register 7 
Control Register 7 

Status Register 8 
Control Register 8 



Current byte within record 
Set current byte within record 

EOF record 
Set EOF record 

Byte within EOF record 
Set byte within EOF record 
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I/O Path Names Assigned 

Status Register 1 

Status Register 2 

Status Register 3 
Control Register 3 

Status Register 4 
Control Register 4 

Status Register 5 
Control Register 5 

Status Register 6 

Status Register 7 

Status Register 8 
Control Register 8 

Status Register 9 
Control Register 9 



to a Buffer: 

Buffer type (1 = named, 2 == unnamed) 

Buffer size in bytes 

Current fill pointer 
Set fill pointer 

Current number of bytes in buffer 
Set number of bytes 

Current empty pointer 
Set empty pointer 

Interface select code of inbound TRANSFER 

Interface select code of outbound TRANSFER 

If non-zero, inbound TRANSFER is continuous 
Cancel continuous mode inbound TRANSFER if zero 

If non-zero, outbound TRANSFER is continuous 
Cancel continuous mode outbound TRANSFER if zero 



Status Register 10 Termination status for inbound TRANSFER 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 





TRANSFER 
Active 


TRANSFER 
Aborted 


TRANSFER 
Error 


Device 
Termination 


Byte 
Count 


Record 
Count 


Match 
Character 


Value = 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Status Register 11 Termination status for outbound TRANSFER 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 





TRANSFER 
Active 


TRANSFER 
Aborted 


TRANSFER 
Error 


Device 
Termination 


Byte 
Count 


Record 
Count 





Value = 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 



Status Register 12 
Status Register 13 



Total number of bytes transferred by last inbound TRANSFER 
Total number of bytes transferred by last outbound TRANSFER 
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Interface Events 



Chapter 



Introduction 

The computer can sense and respond to the occurrence of several events. This chapter de- 
scribes programming techniques for handling the interface events called "interrupts" and 
"timeouts" which can initiate program branches. For more details on event-initiated branches, 
consult BASIC Programming Techniques and the BASIC Language Reference. 



Review of Event-Initiated Branching 

Event-initiated branches are very powerful programming tools. With them, the computer can 
execute special routines or subprograms whenever a particular event occurs; the program 
doesn't have to take time to periodically check for each event's occurrence. 

Events 

The events that can initiate branches are summarized as follows; only the last two, which are 
interface events, are discussed in this chapter. The KNOB and KBD events are described in 
Chapter 9, "The Internal Keyboard Interface"; the END, ERROR, and KEY events are de- 
scribed in BASIC Programming Techniques and the BASIC Language Reference. 

END — occurs when the computer encounters the end of a mass storage file while 
accessing the file. 

ERROR — occurs when a program-execution error is sensed. 

KBD — occurs when an enabled key is pressed. 

KEY — occurs when a currently defined softkey is pressed. 

KNOB — occurs when the "knob" (rotary pulse generator) is turned. 

INTR — occurs when an interrupt is requested by a device or when an interrupt condition 
occurs at the interface. 

TIMEOUT — occurs when the computer has not detected a handshake response from a 
device within a specified amount of time. 
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Service Routines 

The software tfiat is executed when an event occurs is called a service routine; the service 
routine takes action that has been programmed as the computer's response to the event. 
Since most events have only one cause, most service routines execute the same action each 
time the event occurs. However, if an event can be caused by more than one event, the 
service routine must also be able to determine which event(s) have occurred and then take 
the appropriate action(s). 

Required Conditions 

In order for any event to initiate a branch, the following prerequisite conditions must be met. 
Later sections describe how to meet these prerequisites for interface events. 

1. The branch must be set up by an ON-event-branch statement, and the service routine 
must exist. 

2. The event must currently be enabled to initiate a branch. 

3. The event must occur. 

4. The software priority assigned to the event must be greater than the current system 
priority'. 

When all of these conditions have been met, the branch is taken. 

A Simple Example 

The following program shows how events (of different software priorities) are serviced by the 
computer. Subprograms called "Key_l" and "Key_2" are the service routines for the events of 
( ki ) and ( k2 ) being pressed; the software priorities assigned to these events are 3 and 4, 
respectively. Run the program and alternately press these softkeys; the branch to each key's 
service routine is initiated by pressing the key. The system i prio rity is "gr aphed" on the CRT. 
HP-HIL keyboar ds hav e no softk eys th at correspon d to f" kp ] or (kg ] The softkeys which 
correspond with ( ki ) through ( kg ] are labeled ( /I ] through (_78_J- More on this in the 
keyboard chapter. 



100 ON KEY 1 »3 CALL Key_l ! Set up euents and 

110 ON KEY 2>a CALL Key_2 ! assisn priorities. 

120 ! 

130 Low_torie = 100 

lao Mid-tone =300 

150 Hi -tone =^00 

IGO ! 

170 ! 

180 OUTPUT 15" System" ^"Priority" 

ISO y$ = CHR$(B)6:CHR$(10) ! BS 6= LF. 

200 OUTPUT 15" a"6:U$6:"3"&:U$&:"2"&:M$&:"l"6:0$S:"0" 

210 ! 

1 Software priority is specified in the event's set-up statement; the range of priorities that can be specified in this statement is through 15. 
Interfaces also have a "hardware" priority which is different from the software priority. For further details of hardware priority, see the next 
sections of this chapter. 



Interface Events 83 



220 Main: CALL Ba r_S raph ( 7 » "* " ) ! Svs. prior, is 

230 ! always >= 0. 

2^0 BEEP Low_tone » . 1 

250 FOR Jiffv' = l TO 5000 

2B0 NEXT Jiffy 

270 ! 

2B0 GOTO Main ! Main loop. 

290 ! 

300 END 

310 ! 

320 SUB Key_l 

330 CALL Bar_Sraph(4 t"#") ! Plot priority. 

3^0 BEEP Mid_tone ». 1 

350 FOR Iota=l TO 2000 

360 NEXT Iota 

370 CALL Bar_Sraph(a »" ") ! Erase. 

380 SUBEND 

390 ! 

400 SUB Key_2 

410 CALL Bar_iSraph (3 »"*" ) ! Graph priority. 

420 BEEP Hi_tone t . 1 

430 FOR Twinkle=l TO 2000 

440 NEXT Twinkle 

450 CALL Bar_3raph(3." ") ! Erase. 

4B0 SUBEND 

470 ! 

480 SUB Bar_Sraph(Line fChar$) 

490 CONTROL l»i;Line ! Locate line. 

500 OUTPUT i;Char$ ! Bar-draph character. 

510 SUBEND 



If ( k2 ] is pressed after ( ki ] but while the Key_l routine is being executed, execution of 
Key_l is temporarily interrupted and the Key_2 routine is executed. When Key_2 is finished, 
execution of Key_l is resumed at the point where it was tem poraril y interrupted. This occurs 
because ( k2 ] was assigned a higher software priority than ( ki ) . 



System 
Priority 

4 ■■ 
3 -- 
2 -■ 

1 -. 



/ 



'Key_1" execution pre-empted. 



time 



Main program's 
lines being executed. 



"Key_1 " 
being executed. 



"Key_2" 
being executed. 



"Key_1" 

execution 

completed. 



pressed 



pressed 



Main program's 
execution continued. 



Events with Higher Software Priority Take Precedence 
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On the other hand, if [ ki ) is pressed while [ k2 ) Is being se rviced , the computer finishes 
executing Key_2 before executing Key_l. The event of pressing [ ki ] was "logged" but not 
processed until after the routine having higher software priority was completed. This is a very 
important concept when dealing with event-initiated branching. The action of the computer in 
logging events and determining assigned software priority is further described in the next 
section. 



System 
Priority 



4 -- 

3 

2 



S 



time 



Main program's 
execution continued. 



pressed 



"Key_2" 
being executed. 

\ 

pressed 



"Key_1" 
being executed. 



Main program's 
lines being executed. 



An Event with Lower Software Priority Must Wait 



Logging and Servicing Events 

The preceding events may occur at any time; however, the computer is only "concerned" if 
these events have been "set up" to initiate a branch. An example of the computer ignoring an 
event is seen when an undefined softkey is pressed. Since the event has not been set up, the 
computer beeps. No service routine is executed, even though the computer was "aware" of 
the event. Thus, only when an event is first set up and then occurs does the computer "service" 
its occurrence. 

Software Priority 

The computer first "logs" the occurrence of an event which is set up.' After recording that the 
event occurred, the computer then checks the event's software priority against that of the 
routine currently being executed. The priority of the routine currently being executed is 
known as system priority. If no service routine is being executed, the system priority is 0; 
otherwise the system priority is equal to the assigned software priority of the routine currently 
being executed. The following table lists the software priority structure of the computer; prior- 
ity increases from to 16. 



1 Thi' process ol logying ev.'iit ocurrences is doscribad in the section called "Hardware Priority" 
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Software Priorities of Events 

System priority when no service routine is being executed 

(known as the "quiescent level"). 

1-15 . . . . Software-assignable priorities of service routines. 

16 Effective software priority of END, ERROR, and TIME- 
OUT events; the software priorities of these events can- 
not be changed. 



In the above example, system priority was befor e eithe r of the events occurred. When ( ki ) 
was pressed, the system priority became 3. When ( 1(2 ) was subsequently pressed, the system 
first lo gged the event and then checked its priority against the current system priority. Since 
( l<2 ] had been assigned a priority of 4, it pre-empted [ ki ] 's service routine because of its 
higher software priority. 

It is important to note that the computer only services event occurrences when a program 
line is exited. This change of lines occurs either at the end of execution of a line or when the 
line is exited when a user-defined function is called. When the program line is changed, the 
computer attempts to service all events that have occurred since the last time a line was exited. 
The next sections further describe logging and servicing events. 

When execution of Key_2 started, the system priority was set to 4. If any event was to interrupt 
the execution of this service routine, it must havfe had a software priority of 5 (or greater). When 
execution of Key_2 completed, the Key_l service routine had the highest software priority, so 
its execution was resumed at the point at which it was interrupted. 



If ( ki ) was pressed again while its own service routine was being executed, execution of the 
first service routine was finished before the service routine was executed again. Thus, if an 
event occurs that has the same software priority as the system priority, its service routine will 
not interrupt the current routine. The service routine will only be executed if the event's 
software priority becomes the highest priority of any event which has been logged (i.e., after all 
other events of higher software priority have been serviced). 
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Changing System Priority 

Events are assigned a software priority to allow the computer to respond to occurrences of 
events with high software priority before those with lower priorities. Occasionally, service 
routines may contain code segments that should not be interrupted once their execution be- 
gins. In such cases, the entire service routine may not require a high software priority, even 
though a portion of the routine needs a high priority to ensure that it will not be interrupted by 
most other processes. 

The SYSTEM PRIORITY statement can be used in these cases to set the system priority to a 
level higher than the BASIC system would otherwise set it when the branch to the service 
routine is taken. The current system priority can also be determined by calling the SYSTEMS 
function with "SYSTEM PRIORITY" as the argument, which returns a string value of the 
current system priority in the range through 15. Examples are shown in the following prog- 
ram. This program requires the GRAPH BIN file. 

100 GINIT ! Use default plotter is CRT. 

110 GRAPHICS ON 

120 OIEWPDRT 0.131.30(100 

130 WINDOW .2000 .0 .7 

lao I 

150 ON KEY 1 LABEL "Prior. l".l GDSUB Key_l 

IBO ON KEY 2 LABEL "Prior. 2". 2 GOSUB Kev-_2 

170 ON KEY 3 LABEL "Prior. 2". 3 GDSUB Key_3 

180 I 

100 S'/S-Prio r$="SYSTEM PRIORITY" ! Define s t r i n 3 for SYSTEMS, 

2 ! 

210 M a i n _ p r S r a in : ' 

220 DISP "Ouiescent system priority 1 e i,. e 1 = 0." 

230 K=X+1 

240 Sys_p no r=UAL( SYSTEMS (SyS-Prior$) ) 

250 GOSUB PI ot_p rio ri ty 

2G0 GOTO Main_proSram 

270 ! 

280 Key_l: FOR Iota=l TO 100 

290 DISP "Key 1! priority 1." 

300 X=K+1 

310 Sy 5_prior = OAL( SYSTEM* ( Sy s_p ri r$) ) 

320 GOSUB PIot_prio ri ty 

330 NEXT Iota 

340 RETURN 

350 ! 

360 Key_2: FOR TuinKle^l TO 100 

37 DISP "Key 2 i p ri ri ty 2 .'" 

380 X=X+1 

390 Sys_prior = OAL(SYSTEM$(Sys_prio rJ) ) 

400 GOSUB PIot„priority 

410 NEXT TwiriKle 

420 ! 

430 ! Critical routine raise system priority. 

440 SYSTEM PRIORITY 3 

450 FOR Split_second=l TO 100 

4B0 DISP "Subroutine set system priority to 3." 

470 X=X+1 

480 Sys_pri.o r = OAL(SYSTEM$(Sys._priorf ) ) 

490 GOSUB PIot_prio rity 

500 NEXT S p I i t _ s e c n d 

510 ! 

520 ! System priority lowered when finished. 

530 SYSTEM PRIORITY 

540 RETURN 

550 ! 

5G0 Key_3: FOR Jiffy=l TO 100 

570 DISP "Key 3i priority 3." 
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740 


END 









The subroutine called Key_2 raised the system priority from its current level, 2, to level 3 during 
the time that the second FOR-NEXT loop was being executed. During this time, pressing ( ka ) 
will not interrupt the routine, since a priority of 4 or greater is required to interrupt the Key_2 
routine. 

By setting the system priority level in this manner, routines can selectively allow and disallow 
other routines from being executed; routines with higher software priority are allowed to pre- 
empt the routine, while those with the same or lower priority are not. If no other events are to 
interrupt the process, system priority can be set to 15. However, keep in mind that END, 
ERROR, and TIMEOUT events have effective software priorities higher than 15 and can there- 
fore interrupt the service routine (if a branch for one of these events is currently set up). 

When the "critical" code has been executed, the program returns the system priority to the 
value set by the BASIC system when the branch was taken (which was 2 since the key -2 
event was being serviced). Of course, if an event with higher software priority occurs while the 
code segment is being executed, its service routine will pre-empt the critical code segment. 

This technique can also be used within SUB and FN subprograms. Keep in mind that when 
program control is returned from a context, the system priority is returned to the value it had 
when the context was called. 

Hardware Priority 

There is a second event priority, hardware priority, that also influences the order in which the 
computer responds to events. Hardware priority determines the order in which events are 
logged by the system, while software priority determines the order in which events are ser- 
viced. The hardware priority of an interface interrupt is determined by the priority-switch 
setting on the interface card itself^ Hardware priority is independent of the software priority 
assigned to the event by the ON INTR statement. (This statement requires the 10 BIN). 

All events have a hardware priority but not all have hardware priorities that can be changed. 
The following table lists the hardware-priority structure of the Series 200/300 computers. Only 
the optional interfaces' hardware priorities can be changed. 



1 Setting hardware priority on an optional interface is described in the interface's installation manual. 



88 Interface Events 



Hardware Priorities of Interfaces 



Hardware 
Priority 


Interface(s) and Event(s) 
at This Priority 





(Quiescent level; no interface 
is currently interrupting) 


1 


Internal Keyboard 
(KBD, KEY and KNOB events) 


2 


Internal Disc Drive 


3 


Internal HP-IB 
(INTR events) 


3-6 


Optional Interface Cards 
(INTR events) 


7 


Non-Maskable Interrupts 
(such as the RESET key) 



In order to fully understand the differences between hardware and software priority, it is helpful 
to first understand how the computer logs and services events. When any event occurs, the 
interface (at which the event has occurred) signals it to the computer. The computer responds 
by temporarily suspending execution of its current task to poll (interrogate) the currently 
enabled interfaces. 



When the computer determines which interface is interrupting, it records that it has occurred on 
this interface (i.e., logs the event) and disables further interrupts from this interface. This 
event is now logged and pending service by the computer. The computer can then return to its 
former task (unless other events have occurred which have not been logged). 

If other events have occurred but have not yet been logged, they will be logged in order of 
descending hardware priority. This occurs because events with hardware priority lower than 
that of the event currently being logged are ignored until all events with the current hardware 
priority are logged. 

Pending Events 

The ON INTR, OFF INTR, ENABLE INTR, and DISABLE INTR keywords let you set up means, 
within software, to service pending events. In particular, it is possible to accommodate interface 
cards, such as the HP 98630 Breadboard card, for which no driver is installed. You can allow 
interrupts to be detected from BASIC. 
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ON INTR and OFF INTR statements may be executed for any I/O card plugged into the 
computer. If the I/O card does not have a driver loaded, all other I/O statements (CONTROL, 
STATUS, ENABLE INTR, OUTPUT, ASSIGN, etc.) will generate an "I/O interface not pre- 
sent" error 163. Before an interrupt can be generated by the driver-less I/O card, you must 
emulate the ENABLE INTR statement using WRITEIO. For example, if an HP 98630 Bread- 
board card is at select code 17, the statements: 

QIM INTR 17 CALL My_card_isr 

WRITEIO 1 7 »Ca rd_masK_ re S 5Ca rd-wask ! Set the masK 

WRITEIO 17*3 5128 ! Enable the card to interrupt 

Set up the card to call My_card_isr when the Breadboard card interrupts. The two WRITEIO 
statements perform the function of ENABLE INTR. 

When the Breadboard card interrupts, BASIC clears bit 7 of register 3 on the Breadboard card 
(the interrupt enable bit) and logs the interrupt so that the user's BASIC routine will be called at 
the next end of line. No other actions are taken during the hardware ISR. 

To perform a DISABLE INTR function, execute 

WRITEIO 17»3;0 ! Disable the card 

Use this information as required, especially if you wish to use the HP 98630 Breadboard 
interface card for customized I/O. 

Servicing Pending Events 

If the computer was interrupted while executing a program line, execution of the line is resumed 
(after logging all events) and continues until either the line is completely executed or a user- 
defined function causes the line to be exited. When the line is exited, the computer begins 
servicing all pending events. 

When servicing pending events, the computer begins with the event of highest software priority 
and executes the event of lowest software priority last. However, if two or more events have the 
same software priority, the computer services the events in order of descending interface 
select codes. If events have both the same software priority and interface select code (such 
as softkeys with the same software priority), the events are serviced in the order in which they 
occurred. 

The process of logging of events is still taking place while events are being serviced. This 
concurrent action has two major effects. First, events of higher hardware priority will interrupt 
the current activity to be logged by the computer. Second, events which also have higher 
software priority will interrupt the computer's present activity to be serviced. Thus, events of 
high hardware and software priority can potentially occur and be serviced many times 
between program lines. 
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For example, suppose that the following events have been set up and enabled to initiate 
branches. Assume that the events have the hardware priorities shown in the program's com- 
ments. 



100 ON INTR 8.15 CALL Seru_B 

110 ON INTR 1 iia CALL Seru_7 

120 ON KEY 1 »5 CALL Serv.Kl 



Hardware priority G. 
Hardware priority 3 . 
Hardware priority 1. 



The following diagram shows the INTR event on interface select code 8 occuring and being 
serviced several times after one program line has been exited. 



Program line 
being executed. 



Line 
, exited. 

•'Serv_8 
executed. 



Serv_7 
executed. 



Serv„8 
executed. 



Serv_k1 
begun. 



Serv-8 
executed. 



Serv_k1 Next line 
finished, executed. 



t f f" 

* y ' 

These three events 
occur and are logged 



INTR on interface 
select code 8. 



INTR on interface 
select code 8. 



Software priority's main function is to pre-empt events of lower software priority so that more 
"urgent" events can be serviced quickly. Decreasing the system's response time to these urgent 
events may also increase overall system throughput. 
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Setting up Branches 



Again for review, the n:iethods of setting up an event-initiated branch to a service routine are 
as follows for all events. 

1. ON event CALL subprogram name 

2. ON event GOSUB service routine 

3. ON event GOTO service routine 

4. ON event R E C M E R service routine 

The term service routine is any legal branch location for the type of branch specified and 
current context. BASIC Programming Techniques and the BASIC Language Reference fully 
describe the differences between these types of branches. 



Enabling Events to Initiate Branches 

Before an event (which is set up) can initiate a branch, it must first be enabled to do so. The 
power-up state of the computer is that the END, ERROR, KEY, KNOB and TIMEOUT events 
are already enabled to initiate branches; the INTR events must be enabled explicitly with 
separate statements. Further details of enabling these events are described in the "Interface 
Interrupts" and "Interface Timeouts" sections of this chapter. 



Interface Interrupts^ 



All interfaces have a hardware line dedicated to signal to the computer that an interrupt event 
has occurred. The source of this signal can be either the device(s) connected to the interface 
or the interface hardware itself. These possibilities are shown in the following diagram. 



Logical OR of tfie Two Signals 





Interface / 


Computer 




Both types of interrupts are 
— - signalled to the computer in 
the same manner. 




^/ 


from Device 


) ^ 




Interrupt 
from 
Interface 
Hardware 







There are two general types of interrupt events. The first type of event occurs when a 
device determines that it requires the computer to execute a special procedure. The second 
type occurs when the interface itself determines that a condition exists or has occurred that 
requires the computer's attention. 



1 The 10 BIN file must be loaded. 



92 Interface Events 



The first type of interrupt event is usually called a service request. Service requests originate 
at the device. An example is a voltmeter signaling to the computer that it has a reading; 
another is a printer generating a service request when it is out of paper. The service routine 
takes the appropriate action, and the program (usually) resumes execution. 

The second type of interrupt event is used to inform the computer of a specific condition at 
the interface. This type of event originates at the interface. An example of this interrupt 
event is the occurrence of a parity error detected by the serial interface. This error usually 
requires that the erroneous data just received be re-transnriitted. The service routine can often 
correct this error by telling the sender to keep sending the data until the error no longer 
occurs, after which the computer can resume its former task. 

The specific abilities of each interface to detect interrupt conditions and to pass on service 
requests from devices are described in the interface programming chapters. 

Setting Up Interrupt Events 

Both of the preceding types of interrupt-initiated branches are set up with statements such as 
those in the following examples. 

Example 

Set up an interrupt event to be logged, and define the location and software priority of the 
service routine. 

ON INTR Int_sel_code>Priorjty CALL SerMice_roiitine 

The select code of the interface is specified by the first parameter; 1/0 path names cannot be 
used to specify the interface. The second parameter specifies the software priority assigned to 
the event. A subrogram called Service_routine must exist in computer memory at the time the 
program is run. Parameters cannot be passed to the service routine in the ON INTR 
statement; any variables to be used jointly by the service routine and other contexts must be 
defined in common. See the BASIC Language Reference for further details. 

Enabling Interrupt Events 

Before the INTR event can initiate its branch, it must be enabled to do so. The following 
examples show how to enable interrupt events to initiate branches. 

Example 

Enable interrupts occuring at interface select code 7 to initiate the branch set up by an ON- 
event-branch statement. 

ENABLE INTR 7;MasK 

The bit pattern of Mask is copied into the "interrupt-enable" register of the specified interface; 
in this case, register 4 of the built-in HP-IB interface receives Mask's bit pattern. Individual 
bits of the mask are used to enable different types of interrupt events for each interface. Each 
bit which is set (i.e., which has a value of 1) in the mask expression enables the correspond- 
ing interrupt condition defined for that bit. 
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For instance, bit 1 of the HP-IB's interrupt-enable register is used to enable and disable 
service-request interrupts. To enable this event to initiate a branch, bit 1 must be set to a "1". 
Specifying a mask parameter of "2" causes a value of 2 to be written into this register, thus 
enabling only service requests to initiate branches. 

EIMABLE INTR 1 \2 



Most Significant Bit 



Bit 15 



Value = 
- 32 768 



Bit 14 



Other interrupt causes 



Bit 3 



described in subsquent sections 



Value = 
16 384 



Value = 8 



Bit 2 



Value = 4 



Least Significant Bit 



Bit 1 



Service 
Request 



Value = 2 



Bit 



See 

Subsequent 

Sections 



Value = 1 



The mask parameter is optional. If it is included, the specified value is written into the 
appropriate register of the specified interface. If this parameter is omitted, the mask specified 
in the last ENABLE INTR is used. If no ENABLE INTR statement has been executed for the 
specified interface, a value of (all interrupt events disabled) is used. 

Example 

Re-enable a previously enabled interrupt event. 
ENABLE INTR 7 



Since no interrupt-enable mask is specified, the last mask used to enable interrupts on this 
interface is used. 

Service Requests 

You can program a service routine to perform any task(s) that is "requested" by the device 
that initiated the branch. If this event can occur for only one reason, the service routine just 
performs the specified action. However, with many devices, the service request can occur for 
several different reasons. In this case, the program must have a means of determining which 
event(s) occurred and then take action. 



94 Interface Events 



Example 

The following program shows an example of using a service routine that can be initiated by 
only one cause — a service request from a device at address 22 on the built-in HP-IB inter- 
face. 



100 
110 
IZC 
130 
l^C 
15t: 
IGC 
17C 
IBC 

igt: 

2 (. 
ZIC 
y '7 ( 

23(: 
zac 
zsc 

ZGC 

27t: 
zee 
zgc 



! ExafTiPle of seruice routine for HP-IB service requests. 



! 

ON INTR 7 »5 CALL Int r7 

ENABLE INTR 752 

Loop: GOTO Loop 

END 

SUB Intr7 

Z=SP0LL(722) 

ENTER 722;Readin^ 

ENABLE INTR 7 

SUBEND 



Set UP i n t e r f a c e f priority* 
branch type* and location. 

Only s e ru i c e r e =1 u e s t s 
(bit 1 ) are enabled. 

Idle loop. 



Clear INTR cause first. 

T a K e desired action. 

R e - e n a b 1 e s e r u i c e requests. 



The program shows the sequence of steps required to set up and enable interrupt events. 
These steps are as follows. 

1. The interrupt event is set up to be logged, as in line 120. This statement also assigns the 
event's software priority; in this case, the priority is 5. 

2. The event must be enabled to initiate its branch, as in line 150. The mask value speci- 
fies that only service requests (enabled by setting bit 1) can initiate branches. 

3. When the event occurs it is logged. Any further interrupts from this interface are auto- 
matically disabled until this interrupt event is serviced. 

4. A serial poll (line 230) must be performed by the service routine, clearing the interrupt- 
cause register so that the same event will not cause another branch upon return to the 
interrupted context. The serial poll is particular to the HP-IB interface, but analogous 
actions can be performed with the other interfaces. 

5. The actual requested action is performed (line 250). 

6. If subsequent events are to be enabled to initiate branches, they must be enabled be- 
fore resuming execution of the previous program segment, as in line 270. Since no 
interrupt-enable mask is explicitly specified, the previous mask is used. 
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Interrupt Conditions 

The conditions that can be sensed by each type of interface are different. All interrupt condi- 
tions signal to the computer that either its assistance is required to correct an error situation or 
an operating mode of the interface has changed and must be made known to the computer. 

The following service routine demonstrates typical action taken when a receiver-line status 
("RLS") interrupt condition is sensed by the serial interface. 

100 ! Example of i n t e r f a c e - c o n d i t i o n interrupt e u e n t . 

110 

120 ON INTR 9>4 CALL Iritr_9 ! Set up for interface select 

130 ! code 9 and priority of 44 

lao ENABLE INTR 954 ! Bit 2 in mask enables 

150 ! "RLS"-type interrupts only. 



Main program here. 



BOO BUB Intr_g 

BIO ! 

B20 STATUS 9 > 10 Hn t r_cau5e ! Clear intr. -cause red. 

B30 ! 

B40 ! ChecK errors and branch to "fix" routines, 

B50 ! 

BBO IF BIT( Int r_cause t3) = 1 THEN GOTO Framing error 

670 IF BIT( Int r_cause »2) =1 THEN GOTO Parity_error 

S80 IF BIT( Int r_cause >1 ) =1 THEN GOTO Ou e r r un_e r ro r 

G90 IF BIT( Intr_cause »0)=1 THEN GOTO Re c M_buf _f u 1 1 

700 ENABLE INTR 9 ! Ignore others* re-enable 

710 SUBEXIT ! INTRs, and return, 

720 ! 

730 FraminS_error: ! "Fix" and re-enable, 

740 SUBEXIT 

750 ! 

7B0 Parity -error: ! "Fix" and re-enable, 

770 SUBEXIT 

700 ! 

790 Oue r run_e r ro r : ! "Fix" and re-enable, 

800 SUBEXIT 

810 ! 

820 Recy_buf _f ul 1 5 ! "Fix" and re-enable. 

830 SUBEXIT 

840 SUBEND 
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Interface Timeouts 

A "timeout" occurs when the handshake response from any external device takes longer than 
the specified amount of time. The time specified for the timeout event is usually the maximum 
time that a device can be expected to take to respond to a handshake during an I/O state- 
ment. 

Setting Up Timeout Events 

The following statements set up this event-initiated branch. The software priority of this event 
cannot be assigned by the program; it is permanently assigned priority 15. The maximum 
time that the computer will wait for a response from the peripheral can be specified in the 
statement with a resolution of 0.001 seconds. 

Example 

Set up a timeout to occur after the Serial Interface has not detected a response from the 
peripheral after 0.200 seconds. Branch to a subroutine called "SeriaLdown". 

ON TIMEOUT 9 ».2 GOSUB Serial_down 
Example 
Set up a timeout of 0.060 for the interface at select code 8. 

ON TIMEOUT 8 » .OS GOTO Hp_ib_5tatU5 

Timeout Limitations 

Timeout events cannot be set up for any of the internal interfaces except the built-in HP-IB. 

Event-initiated branches are only executed... has been executed. Consequently, the computer 
may wait up to 25% longer than the specified time to detect a timeout event; however, it will 
always at least the specified time before generating the interrupt. 

There is no default timeout time parameter. Thus, if no ON TIMEOUT is executed for a specific 
interface, the computer will wait indefinitely on the device to respond. The only w ay t hat th e 
computer can continue executing the program is for the operator to use the [CLR I/O] (or ( Break ) ) 
key. This key aborts the I/O operation that was left "hanging" by the failure of the device to 
respond to the handshake. 

The times specified for timeouts are passed to subprograms. Thus, unless the time for a time- 
out event is changed in the subprogram, it remains the same as it was in the calling routine. If 
the time parameter is changed by the subprogram, it is restored to its former value upon 
return to the calling context. 
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Chapter 

8 



Introduction 

This chapter describes programming techniques for sending data to and entering data from display 
interfaces^ Configuring and accessing these devices with I/O statements (OUTPUT, ENTER, STA- 
TUS, and CONTROL) is described in this chapter. Many of the I/O concepts and programming 
techniques presented in preceding chapters of this manual are applied in this chapter. Thus, the 
display screen is a convenient tool for visually verifying data output before attempting to send it to 
another device. 

Description of Displays 

This section introduces you to the different types of display devices available with Series 200/300 
computers, and provides an overview of their capabilities. Here are the topics covered: 

• Types of display devices. 

• How the "default display device" is chosen (in machines with more than one display installed). 

• Overview of display features. 

Types of Display Devices 

There are essentially two types of displays available with Series 200/300 computers: 

• Displays with separate alpha and graphics "planes": 

• The alpha screen is produced by character-generator hardware. 

• The graphics screen is produced by bit-mapping hardware. 

• Each can be turned on and off independently. 

• Displays with comb/ned alpha and graphics "planes": 

• Alpha and graphics share the same screen. 

• Both are produced by bit-mapping hardware. 

• Alpha and graphics cannot be turned on and off independently (Series 300 color displays 
have a special mode in which you can do this). 

All Series 200 computers have separate alpha and graphics, except the Model 237 which has a 
bit-mapped display. 

All Series 300 computer displays have combined alpha and graphics. However, you can configure 
Series 300 color (multi-plane) displays to use independent alpha and graphics planes. You can also 
install the HP 98546 Display Compatibility Interface in a Series 300 computer to get separate alpha 
and graphics planes (this interface is essentially the display of the Model 217). Configuring the color 
display and using the compatibility display are both discussed in the "Porting to Series 300" 
chapter of BASIC Programming Techniques. Interactions between graphics and alpha planes is 
described in "Multi-Plane Bit-Mapped Displays" in the "Using Graphics Effectively" chapter of 
BASIC Graphics Techniques. 

1 Using a display for graphics is not described in this chapter. See the BASIC Graphics Techniques manual for that information. 



98 Display Interfaces 



How the Default Display Device Is Chosen 

Select code 1^ is always assigned to the "default display device." However, as previously men- 
tioned, Series 300 computers can have more than one display installed at one time. In such cases, 
the BASIC system has to choose which display will be the default display device. Here is the order 
that the system chooses this device (if both display drivers CRTA and CRTB are present at system 
boot): 

1. The "internal" bit-mapped display. 

a. A Series 300 bit-mapped display. 

b. The HP 98700 Display Controller at "internal" select code 6 (i.e., the "internal/exter- 
nal" switch is set to "internal", and the select code switches are set to 6). 

2. The "internal" non-bit-mapped display. 

a. The HP 98546 Display Compatibility Interface. 

3. An "external" bit-mapped display. 

a. An HP 98700 Display Controller at the lowest "external" select code (i.e., the "internal/ 
external" switch is set to "external", and the select code switches are set to a select code 
in the range 8 through 31). 

If the CRTA driver is not present while booting, step 2 is skipped. Similarly, if CRTB is not present, 
then steps 1 and 3 are skipped. 

You can also switch from one "internal" display to the other "internal" display with CRT CON- 
TROL register 21 (but not between internal and external displays). See the "CRT Status and 
Control Register Summary" section at the end of this chapter for values and effects. 

Overview of Display Features 

Even though there are several choices of displays available with Series 200/300 computers, all have 
similar alphanumeric display capabilities. Here are the general categories of I/O operations you can 
perform with the alphanumeric display. 

• You can OUTPUT characters to any location on the screen through select code 1 (this applies 
only to the logical region known as the "output area," which is described in the next section). 

• You can read characters from any location of the output area with the ENTER statement 
through select code 1. A line-feed character, CHR$(10), is sent following the last non-blank 
character on the line. (A simulated HP-IB End-or-Identify, EOI, signal is also sent with the 
line-feed.) 

• You can configure and read the current modes of display operation with CONTROL and 
STATUS registers. 



1 BASIC provides the CRT function which returns a value of 1. 
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Display Regions 

The BASIC system logically partitions the alphanumeric display into several regions, each of which 
has a specific use. Here is a diagram of the regions. 




' Output Area 



18 = default for 80 x 25 displays 

19 = default for 80 X 26 
41 = default for 128x48 



} Blank Line 

} Display Line 

} Keyboard Area (two lines) 

} Message Results Line 

} Softkey Labels (two lines) 



BASIC Display Organization 

Here is a description of each region, from top to bottom of the display. 

• The "output area" is the logical region on which characters sent to the screen are displayed 
(characters sent with OUTPUT through select code 1, or with PRINT when PRINTER IS CRT). 

• One blank display line separates the output area from other areas. 

• One display line is used for output using the DISP statement. 

• Two display lines are used for keyboard input and output (input with INPUT, LINPUT, and 
ENTER through select code 2; OUTPUT through select code 2). 

• One display line is used for system "messages" and "results." These include error messages or 
results of keyboard computations. 

On machines with HIL keyboards (Series 200 Models 217 and 237, and all Series 300 
computers), the right end of this line is used by the BASIC system for "annunciators" such as 
softkey mode (e.g., System or Use r i) and caps indicator. 

• Two lines at the bottom of the screen are used for softkey labels. (See the subsequent section 
called "Softkey Labels" for further information.) 

• The right-most character of the last line is the "run light," which indicates whether the system is 
running a program, paused, and so forth. (See "Running a Program" in the "Entering, 
Running, and Storing Programs" chapter of BASIC Programming Techniques for details.) 

While the number of lines in the output area may vary according to display size, BASIC provides all 
of these regions on all alpha displays. 
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The Output Area and the Display line. 

Characters sent to the CRT with PRINT statements are displayed in output area. The number of 
lines available can vary depending on what monitor you have. Model 226 and Model 236 
computers provide 18 lines. The Model 237 (bit-mapped) display provides 41 lines. Besides 
some hardware dependency, the number of lines in the output area can be altered by CON- 
TROL Register 13 (of select code 1). You can experiment with the parameters to find the limits 
for your display. The lower limit is 9. Usual upper limits are 25, 26, or 48. Characters sent to the 
display with the DISP statement appear in the display line. 

Type in and run the following program to see these areas. Experiment with different parameters 
for the CONTROL statement in line 10. Try integers in the range 9 to 41. Error messages alert 
you to out of range situations. 



" 5 K ; " in the output area. 
? K ; " in the display line. 



10 


CONTROL 1 tl3;25 


20 


FOR K=l TO IB 


30 


PRINT "This is line 


ao 


WAIT .5 


50 


DISP "This is line 


GO 


WAIT .5 


70 


NEXT K 


80 


END 



You should experiment with the loop upper limit in line 20. After the program executes, scroll 
the displayed text up and down to see what happens. Try values such as 10, 18, 25, and 26 if 
you have a CRT which displays 25 lines by 80 columns. If you have a bit-mapped CRT, try 
values such as 10, 30, 48, and 49. Use CONTROL Register 13 to manipulate the size of the 
output area. Use: 

STATUS 1 >13;Hei3ht 

to return the height of the display screen. 
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Output to the CRT 



Data can also be sent to the output area by directing OUTPUT statements to interface select 
code 1. The following example uses an I/O path name to direct the data to the CRT; the default 
data representation used with the CRT is the ASCII representation. 

100 ASSIGN @Pr inter TO 1 

110 ! 

120 FOR Line=l TO 18 

130 OUTPUT iPrinterT'The OUTPUT Area" 

lao NEXT Line 

150 ! 

IGO END 

Numeric Outputs 

When numbers are output to the CRT by the free-field form of the OUTPUT statement, the 
standard numeric format is used\ The following statements show how trailing punctuation 
within the OUTPUT statement affects the item terminators output after each numeric item. 



Examples 



Results 



OUTPUT 




123»^5G 


123 


, 45G 


OUTPUT 




-123 »45G 


-123 


, asG 


OUTPUT 




-123 »-a5G 


-123 


f-asG 


OUTPUT 




-123;-a5G 


-123- 


-456 


OUTPUT 




123;a5G . 123 

/ 

leading " + " signs 
replaced by a space 


a5G 



String Outputs 

Strings are output to the CRT in a similar manner with free-field outputs; trailing punctuation in 
the statement determines whether or not string-item and statement terminators are output. The 
following examples show how trailing punctuation within the OUTPUT statement affects the 
output of string-item terminators. 



Examples 



Results 



OUTPUT 1 5" One" »"Two" One 

Two 
OUTPUT 1 ;"Three" ;"Four" ThreeFour 

As with free-field outputs to other devices, a trailing semicolon causes the separator of the item 
that it follows to be suppressed. In the above case, the carriage-return and line-feed separators 
which normally follow the output of a string item are suppressed by the semicolon. The next 
paragraphs describe how the carriage-return and line-feed (control characters) are interpreted 
by the CRT. 

1 "Standard numeric format" is further described in Chapter 4, "Outputting Data". 
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Control Characters 

ASCII characters with codes through 31 are defined to be "control" characters. When one 
of these characters is sent to a system resource, it is usually interpreted as a command, rather 
than as data. The complete list of control characters and their corresponding codes and defini- 
tions is given in the ASCII table in the Appendix. 

Four of these characters are used for controlling the CRT display, and all others are ignored 
(i.e., are not displayed and cause no special action when received by the CRT), Run the 
following program and note the results. 

130 BacK5Pace*=CHR$(8) 

140 Line-f eed$=CHR$( 10) 

150 Form_f eecl$ = CHR*(12) 

160 Carria^e_returri$ = CHR$( 13) 

170 ! 

ISO ! 

130 ASSIGN @Crt TO 1 

2 ! 

210 OUTPUT @Crt r'BacK" ! 

220 WAIT 1 

230 OUTPUT @Crt ;BacK5Pace*;"5Pace" 

240 WAIT 1 

250 ! 

2G0 OUTPUT @Crt 5 "Line" 5 

270 WAIT 1 

280 OUTPUT @Crt ;Line_f eed$;"f eed" 

290 WAIT 1 

3 ! 

310 OUTPUT @Crt T'Carria^e" 5 

320 WAIT 1 

330 OUTPUT @Crt ;Carria3e_return$ 5 " return" 

340 WAIT 1 

350 ! 

3G0 OUTPUT @Crt 5 "Form" i 

370 WAIT 1 

380 OUTPUT @Crt ;Fo rm_f eed$ ;"f eed" 

390 1 S P "Scroll down to u i e w p r e u i o u s display" 

400 ! 

410 END 
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Display Before Scroll 



f eei 



Display After Scroll 



Bacspace 
Line 

feed 
returnee 
Fo rm 

feed 



The following table describes the display functions invoked when the specified control charac- 
ter is sent to the CRT (in the "Display functions off" mode). The print position is the column 
and line at which the next character sent to the display will appear. 

Control-Character Functions on the CRT 



Character 


Value 


Defined Action 


Bell 


7 


Causes beeper to output the standard tone; 
no display action is invoked. 


Backspace 
(BS) 


8 


If the print position was not in column 1, 
it is moved "back" one character position; 
if it was in the first column, no action is 
invoked. 


Line-feed 
(LF) 


10 


Moves the print position "down" one line. 


Form-feed 
(FF) 


12 


Scrolls the screen "up" as far as possible, 
prints two blank lines, and places the print 
position at column 1 of the second, print- 
ed blank line. 


Carriage-return 
(CR) 


13 


Causes the print position to be moved to 
the beginning (first column) of the current 
screen line. 


All other control 
characters. 




Ignored. 
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Here is another short example program. Type it and watch the execution. Notice how you can 
use CONTROL statements and selected registers to control CRT display. 



10 


CONTROL 1 .i;i0 


20 


PRINT "let's bacK up a li 


30 


WAIT .6 


ao 


FOR K=23 TO 1 STEP -1 


50 


CONTROL 1 tlilO ! 


60 


CONTROL 1 .0;K ! 


70 


PRINT CHR$(B) J" "i ! 


80 


WAIT .3 ! 


90 


NEXT K ! 


100 


END 



Go to 10th line 
little."; i Print a sentence 

Time to see it. 

Loop for backspacing 
Stay on 10th line. Could do other wavs 
M M e cursor b a c K one space 
Issue bacK space 
Let you see b a c K s p a c i n 3 
Continue loop 



Display-Enhancement Characters 

Some displays have ability to display underlined, blinking, and inverse-video characters. These 
features are accessed by displaying special characters. Both the Output Area and the Display 
Line have these abilities. 



There are eight special bit patterns that control the use of these features. CHR$ ( 128) through 
CHR$ ( 135) cause the following display actions. 



No blinking on 
bit-mapped displays 



Character 


Action Resulting from 


Code 


Displaying the Character 


128 


All enhancements off. 


129 


Inverse mode on. 


130 


Blinking mode on. 


131 


Inverse and Blinking modes on. 


132 


Underline mode on. 


133 


Undedine and Inverse modes on. 


134 


Underline and Blinking modes on. 


135 


Underline, Inverse, and Blinking 




modes on. 



When one of these characters is sent to the CRT, it turns on the corresponding enhancement(s). 
All subsequent characters on the CRT are also displayed in the specified enhancement mode; if 
only a few characters are to be enhanced, a CHR$(128) must be sent to the display after the 
last character to be enhanced, which turns off all enhancements. 

From the preceding table, you may have deduced that certain bits within the character bytes 
turn on these display modes. The following bit pattern and individual bits control these features. 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


1 














Underline 
On 


Blinking 
On 


Inverse 
On 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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Notice that the upper five bits (7 through 3) must be in the pattern shown (numeric value 
= 128). Thus, adding the values 4, 2, or 1 enable the Underline, Blinking, and Inverse features. 
Several examples follow. 

100 PRINTER IS 1 

110 Off =128 

120 Uriderline = a 

130 BliriKiriS = 2 

140 I n y e r s e = 1 

150 ! 

ISO PRINT CHR$(Off ) r'Normal" 

170 PRINT 

180 PRINT CHR$( 128+Inuer5e) r'lnuerse- 
lSO PRINT "carries ouer onto" 
200 PRINT "subsequent lines" 
210 PRINT 

220 PRINT CHR*(12e + Underline) ; "Under line" 

230 PRINT "also remains on until turned off" 

240 PRINT 

250 PRINT CHR$(128 + B1 inK ins ); "Blinking" 

260 PRINT "is the same" 

270 PRINT 

280 PRINT CHR$(Off ) ;"BacK to normal" 

230 PRINT 

300 END 

These same features can also be placed in strings by using the [ANY CHAR) key while initially 
assigning the string variable its value. Keep in mind that, even though these characters are not 
shown on the screen, they are counted in the length of the string. Dimension string variables 
accordingly. 

The Display Functions Mode 

The preceding program showed the control characters which are defined to invoke a special 
display function when sent to some CRTs. To display all control characters sent to the CRT, 
rather than h ave the CRT interpret them as commands, turn the Display functions mode on by 
pressing the (DISPLAY FCTNS) key (or softkey). Repeatedly pressing this key toggles this display mode 
between "on" and "off". Using the CRT with Display functions on is very useful when you need to 
see exactly which control characters have been output. An asterisk is visible in the Display fctns 
softkey label when the Display functions mode is on. (Only true for the HP 46020 keyboard). 

Except for the carriage-retum character, all subsequent control characters sent to the display (while 
in this mode) do not invoke their defined function, but are only displayed. The carriage-return is 
both displayed and causes the print position to move to the beginning of the next line (both CR and 
LF functions invoked). 
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The Display functions mode can also be enabled from BASIC programs with the use of the 
CONTROL statement. The following program shows how this is accomplished. Notice that the 
carriage -return invokes both carriage-return and line-feed functions. 

100 CONTROL l»4;i ! Non-zero = > set. 

110 ! 

120 ! First send with default C R / L F sequence. 

130 OUTPUT i; "DISPLAY FUNCTIONS ON" 

140 ! 

150 ! Then suppress the CR/LF (with "5"). 

ISO OUTPUT 1 ;CHR$( 12) 5 

170 END 



Notice that the "Display functions on" message, normally displayed when the (DISPLAY FCTNS) key (or 
softkey) is pressed, is not automatically displayed when the value of CONTROL register 4 is 
changed; instead, the program must display the message, if so desired. 

The following program uses the CRT mapping register (lines 50 and 210) and the display functions 
register (lines 60, 110, 130, 150, 170, and 200) to display the logical and physical CRT character 
sets. 

1 ! Output ayailafale character sets to CRT 

10 PRINT "If you want to see the ROM contents* THEN ENTER any character" 

20 PRINT "ELSEt to see the legitimate character set. ENTER a null string" 

30 INPUT A$ 

ao PRINT CHR$(12) ! Issue a form feed 

50 CONTROL ltli;LEN(A$) ! Identify which character set 

80 CONTROL l»ail ! Set display functions mode 

70 ! Prouide loop to display cahracter set 

80 FOR 1=0 TO 255 

90 PRINT USING "# .ODD tX ,A .X" ; I tCHR$( 1) 

100 SELECT 1 

110 CASE 1=13 

120 CONTROL 1 .4i0 

130 PRINT ""i 

140 CONTROL 1 »4;i 

150 CASE NOT (I MOD 13) 

180 CONTROL 1 »4;0 

170 PRINT 

100 CONTROL 1 ,4il 

190 END SELECT 

200 NEXT I 

210 CONTROL 1 .fliO 

220 CONTROL 1 .IHO 

230 PRINT 

240 END 
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Output-Area Memory 



In addition to the visible display lines in the output area, there may be additional lines available 
within output-area memory. These additional lines of display memory can be viewed by run- 
ning the following program and then scrolling the display down. The visible lines of output-area 
memory will hereafter be called the screen. Parenthetically, high-resolution displays bit- 
mapped (with 128 X 48 characters) have no scrolling area unless the screen height is changed 
from its default value. 



100 ! Example to show scroll! n 3. 

110 ! 

120 PRINTER IS 1 

130 ! 

laO FOR Lirie = l TO 48 

150 PRINT Line 

IBO NEXT Line 

170 ! 

180 END 



! PRINT on CRT. 
! Write 48 1 ines . 

Now scroll manually. 



Determining Above-Screen Lines 

Scrolling the display up and down allows you to view different portions of the lines within 
output-area memory. If the display is scrolled down as far as possible, there are no lines "above 
screen". Similarly, if the display is scrolled up as far as possible, there are no lines "below 
screen". The following drawing illustrates the screen of a Model 236 with 6 lines above screen. 



Six 

Above-Screen 

Lines 



19- 
20 
21 - 
22- 



49- 
50- 

v51 - 




Lines 1 tlnrough 18 
Are Visible 




18 Lines 
Displayed 



IZiZI 



57 

Total 
Lines 



Line Positions of the Output Area 



The values could vary if you have a different CRT. 
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The number of lines that are above screen can be determined from BASIC programs by reading 
STATUS register 3 of interface select code 1. The returned value is the number of lines 
currently above screen. 



If the screen has just been cleared ( [ Shift ) - [ Clear line ] or fShHTl - t Clear line ] ), the following program 

displays 

lines aboue screen. Running the program a second time displays 

18 lines above sc re en, and so forth until 39 lines aboue s c r e e n is displayed 

continually on a non-bitmapped 25 line CRT. 

100 FOR Line=l TO 18 

110 OUTPUT i;Line 

120 NEXT Line 

130 ! 

lao STATUS 1 »3 SLines-abaue 

150 D I S P L i n e s _ a b u e ; " lines above screen" 

ISO END 

The Print Position 

All of the characters in output-area memory can be addressed individually by the character's 
screen column and line. The character in the upper left corner of the screen is in column 1 and 
line 1, and the character in the lower right corner varies depending on what monitor you have. 
The addresses of the characters "off screen" are limited by the number of lines currently above 
screen. 

The screen addresses (both column and line) at which a subsequent character sent to the 
display appear on the screen are known as the print position. The current print position is 
automatically changed as characters are output to the display. For instance, the print-position 
column is incremented each time a character is sent; when the last is sent to a line, the 
print-position column is reset to 1 and the print-position line is incremented, sending the 
character to the next line. The following program shows how the print-position line varies 
during output to the CRT. 

100 FOR Line=l TO ^8 

110 OUTPUT 1 ;Line 

120 STATUS 1 ,1 ;Print_line 

130 DISP "Print-position line = ";Print_line 

1-aO IF Line<25 THEN WAIT .2 

150 NEXT Line 

ISO ! 

170 END 
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Notice that the print-position line is always relative to the first line of the current screen. 

This accounts for the print position (read with STATUS) remaining at a value of 19 while the 
19th through 48th lines are being printed. When the print position is off screen, the display is 
scrolled (when it receives a character) so that the character appears on the screen. When the 
display is finished scrolling, all line addresses are again relative to the new top screen line. The 
next section describes using this feature to scroll the display from the program. 

Determining Screenwidth 

All programs written and stored on the Model 226 can be run on the Model 236, and vice versa. 
Similar considerations apply when running programs written for an 80-column screen on a 
128-column screen. Programs that use the display extensively have probably been written with 
the 50-character screenwidth in mind. Since all programs are transportable between these 
computers, the program should have the ability to distinguish in which computer it is being 
executed. The BASIC language system provides this capability. 

Interface select code 1 is used to access the CRT from BASIC programs. Several registers are 
associated with this interface which allow interrogating and controlling the CRT through its 
interface. In particular, STATUS register 9 of the CRT interface is dedicated to storing the 
current screenwidth. The following statement determines the current screenwidth. 

STATUS 1 »3 !Sc reenwidth 

The resultant value of Screenwidth differs for each computer: the value of 80 is returned in the 
Model 216, 217, and 236. Fifty is returned in the Model 226. Other values may be returned for 
other display sizes. You can also use SYSTEMS ("CRT ID") to determine screen width (and 
other display attributes). 

Scrolling the Display 

A program can scroll the display up and down by changing the print position to a location off 
screen and then outputting character(s) to the CRT. Assuming a 25 line CRT, in order to scroll 
up, values greater than 18 must be written to register 1. If the screen is to be scrolled up 4 lines, 
the following statements can be used. In this case, the OUTPUT statement outputs the "Null" 
control character so that no characters will be overwritten. 

100 CONTROL l»i;i8+a ! Move print position off screen! 
110 OUTPUT i;CHR$(0)! ! scrolling taKes place when next 
120 ! character sent to the CRT. 

The screen is not scrolled up until the OUTPUT statement actually writes to the CRT at the 
current print position (even though, in this case, no visible character is actually output to the 
display). 

In order to scroll down, a non-positive number must be written into register 1. For instance, 
to scroll down one line, a would be written into register 1. Again, the display is not actually 
scrolled until an OUTPUT (or PRINT) to the CRT is executed. 
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The only restriction on the value of the line number is that it must not attempt to scroll the 
screen down past the first line of output-area memory. In other words, to scroll down as far as 
possible, the following value would be used; using smaller values results in an error. 

Top line's address = - (number of lines abgve screen) + 1 

Thus, if no lines are above screen, the top line's address is 1. 

An example of scrolling down "as far as possible" is shown in the following program. 



IOC 

lie 

120 
13(: 

lac 
i5(: 

IGC 
170 
180 
190 
2 
210 

*? *? {) 

230 
2^0 
250 
2G0 
270 
280 



FDR Lirie = l 1 TO QB 

OUTPUT IJLine 
NEXT Line 
I 

STATUS 1 .1 ;Line_po5 

DISP "Print-position line = " JLi ne_po s ; " after OUTPUT*" 

WAIT 2 

! 

STATUS l»3;Lines_aboi.ie ! Find » lines above screen* 
DISP " and " ;Line5_aboi.ie 5 " lines are aboue screen" 
I^IAIT 3 
I 

CONTROL 1 »1 ;-Lines_aboye + l ! Change line-pos* 

OUTPUT i; "Line 1" ! Scroll made when 1st 

! character is sent* 
! 

STATUS 1 >3 ;Lines_aboi.)e 

DISP " N w t number of lines above screen = " ! L _ a b o v e 

END 
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Entering from the CRT 



Data is entered from the CRT beginning at the current print position. As characters are read 
from the screen (from left to right), the print position is updated. When the ENTER statement 
attempts to read past the last non-blank character on a line, the CRT display's hardware sends a 
line-feed character accompanied by a (simulated) EOI signal, and the print position is advanced 
to the beginning of the next line. Display-enhartcement characters, CHR$(128) through 
CHR$(143), cannot be entered from the CRT memory. 

Reading a Screen Line 

The following program uses the line-feed accompanied by EOI to terminate entry into a string 
variable. Since the free-field ENTER statement is used, only one line can be read because of 
the EOI sent with the line-feed character. 



100 
110 
120 
130 

lao 

150 
IBO 
170 
180 
190 
200 
210 
220 
230 

2ao 

250 
2B0 



CONTROL 155.8 



OUTPUT i;"ABCDEFGH" 
I 

OUTPUT ir'IJKLMNOP 



CONTROL 1 *1 58 



M 1.' e print position to 
5th column of line B » 
then OUTPUT (with CR/LF). 

" ! OUTPUT to line 9 with 
! trailing spacest 
I 

M u e print position back 
to 1st column of line 8 , 



ENTER i;Line_8$ 

DIBP LEN(Line_8*) ; "characte rs read from line 8" 

WAIT 2 
! 

ENTER i;Line_9$ 

DISP LEN(Line_9$) ; "characte rs read from line 9" 

END 



This feature of the CRT is very useful when simulating entry from the HP-IB interface; howev- 
er, keep in mind that no spaces can be read after the last visible character at the end of 
each line. Notice in the preceding example that the trailing space characters sent to the 
display were not read back by the ENTER statement. These trailing characters are treated as 
"blanks" by the CRT, which sends the line-feed with EOI when the ENTER statement 
attempts to read the first one. 

Reading the Entire Output-Area Memory 

Again assuming a 25 line CRT, in order to read all lines within output-area memory, an ENTER 
statement that uses an image must be used to prevent the EOI signal from terminating the 
statement prematurely (since the EOI signal acts as an item terminator during ENTER-USING- 
image statements which contain no "%" image specifiers). The following program shows the 
entire contents of output-area memory being read. 
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100 OPTION BASE 1 

110 DIM Memory$(a8) C503 ! To read 48 lines. 

120 ! 

130 FOR Sc reeri_liine = l TO 48 

140 OUTPUT 1 ;"Line" iScreen-line 

150 NEXT Screen- line 

IGO WAIT 1 

170 ! 

180 STATUS 1 »3 5Lines_aboi.ie 

190 CONTROL i;i>-Line5_abQue+l ! Scroll to read 

200 ENTER 1 USING "K " > Memo rv $ ( * ) ! entire memory. 

210 ! 

220 FOR Sc reen_line=l TO 48 ! Display all lines i 

230 PRINT Memo ry$(Screen_line) 5" "; ! no CR/LF. 

240 NEXT Screen- line 

250 END 

Final Display 

Line 3S 

Line 37 

Line 38 

Line 38 

Line 40 

Line 41 

Line 42 

Line 43 

Line 44 

Line 45 

Line 46 

Line 47 

Line 48 

Line 1 Line 2 Line 3 Line 4 Line 5 Line 6 Line 7 L 

i n e 8 Line 3 Line 10 Line 11 Line 12 Line 13 Line 

14 Line 15 Line IB Line 17 Line 18 Line 19 Line 20 

Line 21 Line 22 Line 23 Line 24 Line 25 Line 28 L 

ine 27 Line 28 Line 29 Line 30 Line 31 Line 32 Lin 

e 33 Line 34 Line 35 Line 38 Line 37 Line 38 Line 

39 Line 40 Line 41 Line 42 Line 43 Line 44 Line 45 

Line 48 Line 47 Line 48 

Notice that the print position was moved to the top line before attempting to read memory 
contents, since the ENTER statement reads characters beginning at the print position. If the 
print position is not at the "top line" of memory before attempting to read all 57 lines, the 
lines above screen will not be read. However, the statement executes with no errors, because 
the CRT sends line-feeds (with EOI) for each line that does not really exist "below screen". 
For instance, if the print position is at line 10 when the ENTER begins, only the last 47 lines of 
output-area memory will be read (and placed into the first 47 elements of Memory$). When 
the ENTER statement attempts to fill last ten elements of Memory$, the CRT sends only 
line-feeds accompanied by EOI because the print position is past the last non-blank character. 
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Additional CRT Features 

This section describes the remainder of features of the CRT display controllable by BASIC 
programs. Interrupt and timeout events are not available with the CRT interface. 

The DISP Line 

BASIC programs can output characters to the DISP Line with the DISP statement, as de- 
scribed in the BASIC Language Reference. As with the output-area's print position, the posi- 
tion (column) within the DISP line at which subsequent characters will appear can be read 
and changed explicitly by BASIC programs. This DISP-line position can be read and 
changed with STATUS register 8 and CONTROL register 8 (of interface select code 1), re- 
spectively. 

iOO FDR Di5P_P05=aG TO 1 STEP -1 
110 CONTROL 1 ,8;Disp_P0S 
120 DISP "HELLO" 
130 WAIT ,2 

lao NEXT Disp_pos 

150 END 

Keep in mind that if trailing carriage-return and line-feed characters are output to the DISP 
line, the carriage-return returns the DISP-line position to column 1. A subsequent DISP state- 
ment clears the entire line. However, if these trailing characters are suppressed, the DISP-line 
position is left unchanged. Run the following program to see these effects. 

100 PRINT "First with trailinS CR/LF»" 

110 DISP "HI" 

120 WAIT .5 

130 DISP " THERE" 

laO WAIT 1 

150 ! 

IGO PRINT "then with no CR/LF*" 

170 DISP "HI"; 

180 WAIT ,5 

190 DISP " THERE" 

200 END 

Also notice that if a DISP attempts to send characters to the DISP line so that any character will 
be past the last column (50, 80, or 128 depending on your CRT), the entire line is shifted left so 
that all of the new characters will be displayed (i.e., so that the last character written will end up 
in the last column. 

100 CONTROL 1 ,8 540 

110 DISP "CHARACTERS" 5 ! No CR/LF. 

120 WAIT 1 

130 DISP " SHIFTED LEFT" 

1^0 ! 

150 END 
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The display-enhancement characters produce the same effects in the DISP Line as in the 
Output Area. 

Disabling the Cursor Character 

BASIC programs even have control over whether any cursor is displayed (during all computer 
modes, such as during EDITs and other keyboard-entry modes). The cursor is disabled with 
the following statement. 

CONTROL 1 ,10iO 

Any non-zero value written to this register re-cnables the cursor to be displayed. Resetting 
the computer also re-enables the cursor being displayed. 

CONTROL 1 ,10 ;i 

Enabling the Insert Mode 

The insert mode of the keyboard area can be enabled and disabled with CONTROL state- 
ments. If any non-zero numeric value is written to register 2, the insert mode is enabled. All 
subsequent characters typed into this area are "inserted" between the cursor and the character 
to its immediate left, and characters to its right are shifted appropriately. 

The following program turns insert mode on for approximately five seconds. During this time, 
use the knob to move the cursor left and right while typing in characters from the keyboard. 



IOC 

1 IC 
IZC 
IOC 

lac 

15( 
IGC 
17( 
IBC 
19( 

2 
ZIC 

230 
240 
250 



Iri se rt_(iio d e = 1 

CONTROL 1 »2 Unse rt„(Tiode 

I 

DISP "Insert mode is now b e i n a use d " 

BEEP 200 ». 2 

WAIT 5 
I 

I n se rt_(no d e = 

CONTROL 1 ,2 ; Inse rt_mode 

DISP "Now the mode has changed to o u e r w r i t e 

BEEP 100 ». 2 

WAIT 5 

I 

BEEP 50,, 2 

DISP "Program ended" 

END 
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Softkey Labels 

Softkeys can be defined as: typing-aid keys or as keys that initiate program (ON KEY) branches. 
In any usage, two display lines (near the bottom of the CRT) can be used for key labels. The 
topic of typing-aid keys is discussed in Chapter 2 of BASIC Programming Techniques; using 
softkeys to initiate program branches is discussed in Chapter 3 of the same manual. Softkey 
labels for systems which use an HIL keyboard are discussed in the BASIC User's Guide. 

Softkey labels can be turned off and on by writing to CRT CONTROL Register 12. The values 
written to the register have the following effects: 



Value of CRT 
Register 12 



Effect on Key Labels 







Typing-aid key labels are displayed 
until the program is run, at which 
time they are turned off (until at least 
one ON KEY is executed). Annun- 
ciators, if present, stay on. System 
menu softkeys are displayed even 
when a program is running. (This is 
the default for systems with a 98203 
keyboard. ) 

Typing-aid and softkey labels are not 
displayed at any time. 

Typing-aid and softkey labels are 
displayed at all times. (This is the de- 
fault for systems with an HIL 
keyboard. ) 



The default value of this register is (2 for systems using an HIL keyboard), which is restored at 
power-on and when SCRATCH A is executed. The register's current contents can be deter- 
mined by reading STATUS Register 12. 



Note that you can draw a solid line between the two lines of key labels (on machine with an HIL 
keyboard). Putting a CHR$ (132) as the first character of the label causes the line to be drawn. 
An example of this technique is the System key labeled CI r Tab (above the line) and Set 
Tab (below the line). 
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Here is an illustrative program which shows cycles through Register 12 with the values 0, 1, and 
2. 

1 ! Set UP clear screen mechariism and subroutine 
3 C$ = CHR$(255)&:"K" 

a GOSUB 1000 

10 ! T 3 3 1 e Key d i s p 1 a >' s 

20 PRINT "SoftKev labels are toSSled," 

21 WAIT 2 

30 ! Set UP to sale loop. 

31 FOR J=l TO 3 

^0 FOR ToS3le=0 TO 2 

IM G0SU6 1000 

50 PRINT "Flas ualue =";To33le 

GO CONTROL 1 (12;To?gle 

70 WAIT 1.5 

80 NEXT To sale 

81 NEXT J 
30 ! 

100 STOP 

1000 OUTPUT 2 USING "«tK";C$ 

1010 RETURN 

1020 END 

If you have an HP 46020 keyboard, try running the program with the User menu up and with 
the System menu up. 

You can use CONTROL register 2 (of select code 2) to cycle the menus; = System, 1 = User 1, 

2 = User 2, and 3 = User 3. For example, 

CONTROL 2»2;3 

displays the menu for User 3. 

CONT ROL register 14 (of select code 2) can be used to invoke function key bases or 1 (i.e., 
( /I ] is KEY 0, ( /2 ) is KEY 1, etc.) The default is 0, which means the function keys start at 1. 
Changing the flag value to 1 starts the function keys at 0. You might also need to deal with this 
because the function keys on some keyboards are labeled from to 9, and from 1 to 8 on other 
keyboards. 
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CRT Status and Control Registers 



Status Register 
Control Register 

Status Register 1 
Control Register 1 

Status Register 2 
Control Register 2 

Status Register 3 
Control Register 3 

Status Register 4 
Control Register 4 

Status Register 5 
Control Register 5 



Current print position (column) 
Set print position (column) 

Current print position (line) 
Set print position (line) 

Insert-character mode 

Set insert character mode if non-0 

Number of lines "above screen" 
Undefined 

Display functions mode 

Set display functions mode if non-0 

Returns the CRT alpha color value set (or default). This does not 
reflect changes due to printing CHR$(x), where 136^x^143. 

Set default alpha color: 
For Alpha Displays: 



Value 


Result 


<128 


Error 


128-135 


Ignored ~ 


136 


White 


137 


Red 


138 


Yellow 


139 


Green 


140 


Cyan 


141 


Blue 


142 


Magenta 


143 


Black 


144-159 


Ignored 


>159 


Error 



}^H ^ 



lAMi^ 



Status Register 6 
Control Register 6 

Status Register 7 
Control Register 7 



For Bit-Mapped Displays: 

Values thru 255 which correspond to the graphics pens. 

For multi-plane bit-mapped displays, the graphics pen to be used for 
alpha. 

CONTROL CRT .5 in sets the values of the CRT registers 15, 16, and 17, 
but the converse is not true. That is, STATUS CRT »5 may not accurately 
reflect the CRT state if CONTROL 15, IB, and/or 1 7 have been executed. 

ALPHA ON flag 
Undefined 

GRAPHICS ON flag 
Undefined 
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CRT Status and Control Registers (cont.) 



Status Register 8 
Control Register 8 

Status Register 9 
Control Register 9 

Status Register 10 
Control Register 10 

Status Register 1 1 
Control Register 1 1 

Status Register 12 
Control Register 12 



Status Register 13 
Control Register 13 

Status Register 14 
Control Register 14 



Display line position (column) 
Set display line position (column) 

Screenwidth (number of characters) 
Undefined 

Cursor-enable flag 

Cursor-enable: - cursor invisible 

non-0 = cursor visible 

CRT character mapping flag 

Disable CRT character mapping if non-0 

Key labels display mode 

Set key labels display mode: == typing-aid key labels displayed un- 
less program is in the RUN state 

1 = key labels always off 

2 = key labels displayed at all times 

CRT height 

CRT height; number of lines in Alpha display must be greater than 8. 

Display replacement 
Display replacement 

0-0 

1-source AND old 

2-source AND NOT old 

3-source; default 

4-NOT source AND old 

5-old 

6-source EXOR old 

7-source OR old 

8-source NOR old 

9-source EXNOR old 
10-NOT old 
1 1-source OR NOT old 
12-NOT source 
13-NOT source OR old 
14-source NAND old 
15-1 
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CRT Status and Control Registers (cont.) 



Status Register 15 



Control Register 15 



Status Register 16 
Control Register 16 



Return the value set (or the default) for the color in the PRINT/DISP 
area. This does not reflect changes due to printing CHR$(x), where 
136^x^143. 

Set PRINT/DISP color. Similar to CRT control register 5 but specific to 
CRT PRINT/DISP areas; that is, it does not affect the areas covered by 
CRT registers 16 and 17. 

Return the value set (or the default) for the softkey label color. 

Set key labels color. Similar to CRT control register 5 but only affects 
the softkey labels. Does not affect the areas covered by CRT registers 
15 and 17. 



Status Register 17 



Control Register 17 



Status Register 18 
Control Register 18 
Status Register 19 
Control Register 19 

Status Register 20 
Control Register 20 

Status Register 21 

Control Register 21 



Return the value set (or the default) for the color of the "non- 
enhance" area. This includes the keyboard entry line, runlight, system 
message line, annunciators, and edit screen. 

Set "non-enhance" color. This includes the keyboard entry line, run- 
light, system message line, annunciators, and edit screen. Similar to 
CRT control register 5 but does not affect the areas covered by CRT 
control registers 15 and 16. 

Read the alpha write-enable mask. 

Set alpha write-enable mask to a bit pattern. 

Return number of planes in alpha CRT. 

Undefined. 

Read the alpha display-enable mask. 

Set alpha display-enable mask to a bit pattern. 

Return compatibility mode (0 or 1). 

Switch between the CRT compatibility mode (value ^0) and the na- 
tive bit-mapped mode (value = 0). That is, switch both alpha and 
graphics to non-bit-mapped display (if value i^ 0) or bit-mapped dis- 
play (if value = 0). It effectively initializes the alpha display and ex- 
ecutes a GINIT and a PLOTTER IS CRT ("INTERNAL". 
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Keyboard Interfaces 



Chapter 

9 



Introduction 

As with displays, access to keyboards can be made with OUTPUT, ENTER, CONTROL, and 
STATUS statements. This chapter describes I/O programming techniques for "interfacing" to the 
keyboard. 



Description of Keyboards 

This section introduces you to the different types of keyboards available with Series 200/300 
computers, and provides an overview of their capabilities. Here are the topics covered: 

• Types of keyboards. 

• How the "primary" keyboard is chosen (in machines with more than one keyboard installed). 

• Overview of keyboard features. 

Types of Keyboards 

There are essentially three types of keyboards available with Series 200/300 computers: 




ooooqohbib 
iqobodbbIib 



The HP 98203A Keyboard 
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DCUC 



G^l- -l--] 
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3EE3 




mpGDPQQ 
BDEIlII 



lEElDI 



[lEDEEDEEElCHI] 



GQDD 
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IDDDEJ ED QDDD 
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The HP 98203B Keyboard 




islDBBDQDDQDBDDDD BS 



B 



BE a 



nnoD 



QDQD 



HP-HIL (46020) Keyboards 

Series 200 Models 216 and 220 computers may have the smaller 98203A keyboard or optionally 
the larger 98203B keyboard. Models 226 and 236 computers have built-in 98203B keyboards. 
Models 217 and 237 have the Human Interface Link (HIL) keyboard (such as the HP 46020 
keyboard). 

All Series 300 computers have HIL keyboards. 

Complete descriptions of the BASIC definitions of each key of every keyboard is provided in the 
"Keyboards" chapter of the BASIC User's Guide. 

There is also a mode of operation, enabled and disabled via KBD CONTROL register 15, in which 
HIL keyboards can emulate a 98203B keyboard; see the "Keyboard Status and Control Register 
Summary" section at the end of this chapter for values and effects. Details of using this mode are 
provided in the "Porting to Series 300" chapter of BASIC Programming Techniques. 
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How the Primary Keyboard Is Chosen 

Select code 2^ is always assigned to the keyboard interface. However, Series 200/300 computers 
can have more than one keyboard installed at one time. In such cases, the BASIC system has to 
choose which one will be the primary keyboard. Here is the order that the system chooses this 
keyboard; 

1. If there is an "internal" keyboard, then it is chosen as the primary keyboard. Examples are as 
follows: 

a. The 98203 keyboard on a Series 200 computer. 

b. The HIL keyboard on a Series 200 or 300 computer^. 

2. If there is an "external" HIL keyboard, and no "internal" keyboard, then it will be chosen as 
the primary keyboard. An example is: 

a. A keyboard connected to the HIL port of an HP 98700 Display Controller. 
Any other keyboards will not be recognized by the BASIC system. 

Note that the primary keyboard determines the keyboard language and which softkey labels are 
chosen. Thus, if two keyboards with different languages are connected to the computer (and 
recognized by BASIC), then the language and softkey labels of the primary keyboard are used. This 
effect may cause some keys on the secondary keyboard to produce incorrect characters. 

Re-Configuring HIL Devices 

If you add or remove HIL devices while the BASIC system is in the computer, you must re- 
configure in order for BASIC to properly recognize all devices. Executing SCRATCH A initiates this 
re-configuration. 

Overview of Keyboard Features 

Series 200/300 computer keyboards are controlled by their own separate processors, which allows 
many more capabilities than most other desktop-computer keyboards. These keyboards are de- 
vices which reside at select code 2^. Here is a brief list of keyboard capabilities: 

• You can use the ENTER statement to enter data from the keyboard, and thus simulate devices 
for debugging purposes. 

• You can monitor keys and the "knob" (rotary pulse generator), if present, and enable them to 
interrupt BASIC programs; the BASIC program can contain a segment of code to read and use 
this input. 

• You can OUTPUT commands to the keyboard, simluating an operator entering them. You can 
also OUTPUT data to the keyboard which the operator can then edit and send back. 

Note, however, that the INTR and TIMEOUT event-initiated branches cannot be sensed by the 
keyboard. 



1 BASIC provides the KBD function which returns a value of 2. 

2 If two keyboards are connected to the same HIL interface, the one closest to the computer is chosen. 
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ASCII and Non-ASCII Keys 

The keys of the Series 200/300 computer keyboards can be generally grouped by function into the 
ASCII and non-ASCII keys. The ASCII (or alphanumeric) keys all produce an ASCII character 
when pressed, and include the character entry and numeric keys. The non-ASCII (or non- 
alphanumeric) keys do not prod uce characters but initiate specific action when pressed; the 
( Return ) , [ENTER) , and [ BACK SPACE ) keys are non-ASCII keys for this reason. Non-ASCII keys also 
include all program control, editing, cursor control, and system control keys. 



The (Extend char] key, when present, is held down while you press other keys from the main 
typewriter section to generate the rest of the available 256 ASCII characters. 

The Shift and Control Keys 

The ( SHin ) and ( CTRL ) keys are not really either type of key because neith er can cause action on its 
own; instead, they are used only with the other types of keys. Pressing the ( SHIR ) key with another 
key qualifies the other keypress, allowing the other key to have a second meaning. For instance, in 
the "Caps lock off" mode, pressing an alphabetic ASCII key generates a lowercase alphabetic 
character. Pressing the ( SHIFT ] key simultane ously with an alphabetic key in the "Caps lock off" 
mode generates an uppercase character. The ( SHIFT ) key is used similariy with the non-ASCII keys, 
allowing many of those keys to have a second function. 



The ( CTRL ] (Control) key is also used to further qualify both ASCII and non-ASCII keypresses. 
Pressing the ( CTRL ) key simultaneously with an ASCII ke y generates an ASCII control character in 
the display, and is often faster than using the ( ANY CHAR ) ke y. Th e following table shows how to 
generate control characters by simultaneously pressing the PCTRL ] key and typing keys(s). This is 
particularly useful when you need to include a control character in a string. 
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Generating Control Characters with CTRL and ASCII Keys 



Key 
Code 


ASCII 
Character 


Character's 
Description 


Key(s) Pressed 
with CTRL 


Character 
on CRT 




1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 

16 

17 

18 

19 

20 

21 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 


NUL 

SOH 

STX 

ETX 

EOT 

ENQ 

ACK 

BEL 

BS 

HT 

LF 

VT 

FF 

CR 

SO 

SI 

DLE 

DCl 

DC2 

DCS 

DC4 

NAK 

SYN 

ETB 

CAN 

EM 

SUB 

ESC 

FS 

GS 

RS 

US 


Null 

Start of Header 

Start of Text 

End of Text 

End of Transmission 

Enquiry 

Acknowledgement 

Bell 

Backspace 

Horizontal Tab 

Line-Feed 

Vertical Tab 

Form-Feed 

Carriage-Return 

Shift Out 

Shift In 

Data Link Escape 

Device Control 

Device Control 

Device Control 

Device Control 

Neg. Acknowlegdement 

Synchronous Idle 

End of Text Block 

Cancel 

End of Media 

Substitute 

Escape 

File Separator 

Group Separator 

Record Separator 

Unit Separator 


(space bar) 


Sh 

Ex 

Eo 

iX 

»T 
<-F 

•■'t 

Dl 

^3 
°4 

By 

Em 

Sb 

Ec 


[ A ) 


[ B ] 


( c ] 


Ld J 


[ E 1 


( F ) 


[ G ) 


( H ] 


( 1 ] 


( J ] 


( K ] 


( L ] 


( M ] 


[ N ) 


( ) 


( P ) 
( Q ] 


( R ) 
( s ) 


[ T ) 


( u ] 

( V ) 


( w ) 


( X ) 


[ Y ) 


( z ) 


[ [ ) 
( SHIFT )-[ f ] 


( ] ) 


( t ] 


[ SHIFT)-! / ) 



Pressing the [ ESC ] key on the HP 46020 keyboard is an alternative to ( CTRL]( [ ~) . The keys 
listed in the preceding table are not the only ways to generate control characters, but are 
generally the simple st and most easi ly me morized method. For instance, to generate a line-feed 
character, press the ( CTRL ] and the [ J ] keys simultaneously. 



CctrD-CO 



Pressing the ( CTRL ) key with a non-ASCII key is used to generate and store non-ASCII keystrokes 
within strings and is further discussed in "Outputs to the Keyboard". 
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Keyboard Operating Modes 



The keyboard has two operating modes which can be changed within a program with the 
CONTROL statement. This section describes changing these modes from the program. 

The Caps Lock Mode 

Pressing the (CAPS LOCK] key toggles the keyboard between the "Caps lock on" and "Caps lock off" 
modes. In the "Caps lock on" mode, pressing any alphabetic key causes an uppercase letter to be 
displayed on the screen; in the "Caps lock off" mode, these keys generate lowercase letters. This 
mode can be changed with the CONTROL statement and sensed with the STATUS statement. 
Writing any non-zero numeric value into register (of interface select code 2) sets the caps lock 
mode on: writing a zero into this register sets the mode off. 

100 STATUS 2;CaP5_lDcK ! ChecK mode* 

110 ! 

120 PRINT "Initially* "5 

130 IF CaP5_locK=l THEN • 

lao Mode$="ON" 

150 ELSE 

ISO Mode$="OFF" 

170 END IF 

180 ! 

ISO PRINT "CAPS LOCK was "&:Mo d e$6:CHR$ ( 1 ) ! SKip line. 

200 BEEP 

210 WAIT 1 

220 ! 

230 CONTROL 251 

2a0 PRINT "CAPS LOCK now ON" 

250 PRINT "Type in a few c ha rac t e rs " &:CHR$ ( 1 ) 

2G0 WAIT 4 

270 ! 

280 CONTROL 2;0 

230 PRINT "CAPS LOCK now OFF" 

300 PRINT 

310 BEEP 

320 END 

The Print All Mode 



Pressing the ( PRT ALL ] key (or the softkey in the SYSTEM menu) toggles the "Print all" mode 
"on" and "off. The "Print all" mode can also be sensed and changed by reading and writing to 
STATUS register 1 and CONTROL register 1 (of interface select code 2). Writing a non-zero 
numeric value into this register sets the "Print all" mode on; writing a value of zero turns this mode 
"off". The following statement turns the "Print all" mode off. 

CONTROL 2 »1 ;0 
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Modifying the Repeat and Delay Intervals 

The keyboard has an auto-repeat feature which allows you to hold a key down to repeat its 
function rather than pressing and releasing it repeatedly. Holding a key down will cause it to 
be repeated every 80 milliseconds for as long as it is is held down, resulting in a repeat rate of 
approximately 12.5 characters per second. However, you may have noticed that the initial 
delay between the key being pressed and the key being repeated is longer than successive 
delays between repeats; the initial delay before a key is repeated for the first time is 700 
milliseconds (7/10 second). The following plot of a key's default repeat function shows these 
two intervals. 

Initial 1s1 2nd 3rd 4th 

Keystroke Repeat Repeat Repeat Repeat ... 



700ms 



80ms 



80ms 



80ms 



Initial delay Repeat 

intervals 

These intervals can be changed from the program, if desired, by writing different values into 
CONTROL registers 3 and 4 (of interface select code 2). Register 3 contains the parameter 
that controls the auto-repeat interval, and register 4 contains the parameter that controls the 
initial delay. The values of these parameters, multiplied by 10, give the respective intervals in 
milliseconds with the following exception; if register 3 is set to 256, the auto-repeat is dis- 
abled. 

The following program sets up softkeys 1, 4, 6, and 8 to change these parameters. Run the 
program and experiment with these intervals to optimize them for your own preferences and 
needs. 

Note 



Softkey keyboard labels (on the keycaps) are [ M ] through ( fZ ] 
on HIL keyboar ds. In d efault mode, the correspondence be- 
tween key labels ( [ /I ) , ( /2 ] , etc.) a nd KEY nu mbers (in ON 
KEY and with typing-aid keys) is ( n ] = KEY 1, [ f2 ] = KEY 
2, etc. You can change this con-espondence by writing a 1 into 
keybo ard control regist er 14; the new correspondence will be 
(mH - KEY 0, (n) = KEY 1, etc. 

100 ON KEY 1 LABEL "Faster" GOSUB Dec r_in t e ru al 

110 ON KEY a LABEL "Slower" GOSUB Inc r_inte rual 

120 ON KEY G LABEL "Sooner" GOSUB Decr_delay 

130 ON KEY 8 LABEL "Later" GOSUB Incr_dela-/ 

lao ! 

150 InterMal=80 ! Defaults* 

IBO Del ay = 700 

170 ! 

180 DISP "Interual = " ;interual ;" Delay= "SDelay 

190 GOTO 180 ! Loop. 

200 ! 

210 Incr_interual:Interi.ial = InterMal + 10*(Interual<25B0) 
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23( 

zac 

25( 

zee 
27(: 

ZBC 

29(: 

3 (. 
SIC 
320 
330 

3 an 

350 
3B0 
370 



CONTROL 2 >3 ; Inte rual/10 

RETURN 

I 

D e c r _ i n t e r M a 1 : I n t e r u a 1 = I n t e r u a 1 - 1 * ( I n t e r u a 1 • 

CONTROL 2 .3;iriteri.)al/10 
RETURN 
I 

I n c r _ d e 1 a y : D e 1 a y = D e 1 a ■/ + 1 * ( D e 1 a y < 2 5 G ) 
CONTROL 2»a;Delay/10 
RETURN 
I 

D e c r_ d e 1 a y : D e 1 a y = D e 1 a y - 1 0* ( D e 1 a y > 1 ) 
CONTROL 2»a;Delay/10 
RETURN 
! 

END 
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Entering Data from the Keyboard 

When the keyboard is specified as the source of data in an ENTER statement, the computer 
executes the process just as if entering data from any other device The computer signals to the 
keyboard that the keyboard is to be the sender of data. The keyboard in turn signals that it is not 
ready to send data and waits for you to type in and edit the desired data. 

The characters you type in appear in the keyboard area of the display, but they are not 
automatically sent to the computer. As long as you can see the characters, you can edit them 
before sending them to the computer, just as during an INPUT statement. Available charac- 
ters inclu de all 256 characters that can be generated either with keystrokes or with the 
[any char] key (or softkey). 



Pressing the [ ENTER] , [Return) , [ STEP ) , or [ CONTINUE ] key or softkey signals the keyboard that the data 
is to be sent to the computer. The data is then sent byte-serially according to an agreed-upon 
handshake convention. The computer enters the data in byte-serial fashion and processes it accord- 
ing to the specified variable(s), type of ENTER statement, and image (if it is an ENTER USING 
statement). 

The differences in pressing the keys or softkeys in the above paragraph are as follows. Keep in mind 
that the ENTER statement is still being executed as long as the "'^" appears in the lower right 
corner of the display. 



[Return] 
or 

[enter] 

or 

(jteT] 



All of the characters displayed in the keyboard area are sent to the computer, followed 
by carriage-return and line-feed characters. These last two characters usually termin- 
ate entry into the current item in the ENTER statement. In addition, the [ STEP ] key 
causes the computer to remain in the single-step mode after the ENTER statement has 
been completely executed. 



( CONTINUE 1 All of the characters displayed in the keyboard area are sent to the computer for 
processing; no trailing carriage-return and line-feed characters are sent. The [ CONTINUE ] 
key is pressed if more characters are to be entered into the current variable in the 
destination list of the ENTER statement. 
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Type in and run the following program. Experi ment with how entry into e ac h vari able item is 
terminated by usin g the d if ferent keys (i.e. the [ CONTINUE ) key versus [ Return) , (ENTER) , or ( STEP ) 
keys). Pressing the ( Return ) , (ENTER) , or ( STEP ) key terminates entry into the current variable, while 
pressing the ( CONTINUE ) key allows additional characters to be entered into the current variable. 

100 DIM St rin3_array$( 1 :3) C 100] 

110 ASSIGN @Deuice_si(Tii.ilate TO 2 

120 ! 

130 ENTER @Deuice_5irriulate ;St rin^-ar ra>'$<*) 

lao ! 

150 OUTPUT 1 ;St rina_arrav'$(*) 

ISO ! 

170 END 

This use of the keyboard is very powerful when tracing the cause of an error in an enter 
operation. With this tool, you can "debug" or verify any type of ENTER statement, including 
ENTER statements whose source is intended to be a device on the HP-IB interface. The next 
section describes this topic. 

Sending the EOI Signal 

The EOI signal is implemented on the HP-IB interface. This line ordinarily signals to the 
computer that the data byte being received is the last byte of the item; thus, it is either an item 
terminator or a terminating condition for the ENTER statement'. 

The EOI signal can be simulated from the keyboard when this feature is properly enabled. 
CONTROL register 12 of interface select code 2 controls this feature; the following example 
statement shows how to enable this feature. 

CONTROL 2»12;i 



To simulate the EOI signal with a character, the ( CTRL ) and ( E ) (or ( Shift )( * ) on the numeric 
keypad) keys are pressed simuitaneously before the character to be accompanied with EOI is 
typed in. For instance, if the characters "DATA" are to be entered and the E OI is t o accom p any th e 
last "A", the following key sequence should be pressed before pressing the ( Return ) , (ENTER) , ( STEP ) , 
or ( CONTINUE ) key (or softkey). 



CXD CO OD rcrni-m m 

The same result can be obtained by placing an ENQ character (ASCII control character 
CHR$(5),Eo) in front of the character to be accompanied by the EOI signal (see the previous 
section for further details). 



1 See Chapter 5 for further explanation of the EOI signal's effects during ENTER. 
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Sending Data to the Keyboard 

Characters output to the keyboard are indistinguishable from characters typed in from the 
keyboard. All charactes output to the keyboard, including control characters, are displayed in 
the keyboard area. The following program outputs the BEfEP statement to the keyboard. Read 
on to see how it works. 

100 OUTPUT 2; "BEEP"; ! No CR/LF. 
110 ! 
120 END 

Sending Non-ASCII Keystrokes to the Keyboard 

The preceding program sent the chara cters BEEP to the keyboard, but the statement was not 
executed. Pressing the (ENTER] or (Return) k ey a fter the program has end ed exe c utes th e statement. 
Modify the program to "press" the (ENTER) or (Return) key by typing in ( CTRL ] (ENTER) (or ( Return ) ) 
following the BEEP. Sending this special t wo-ch aracter sequence to the keyboard is equivalent 
to the operator pressing the (ENTER) or (Return) k ey. Thus, in general, to store a non-ASCII 
"keystroke" within a program line, press the ( CTRL ) key while simultaneously pressing the desired 
non-ASCII key. 

Since CHR$(255) does not generate the same character on most printers as it does on the Model 
226 display, it is recommended that some explicit means of documenting these character se- 
quences be employed. For instance, string^ variables can be defined to contain these sequences; 
then when the program is listed on an extern al print er, it will be much easier to determine which 
non-typing keys are being represented. The [ CTRL ) key is still used with the non-ASCII key to 
generate the two-character sequence, but the special character should be changed to a 
CHR$(255). 

100 En t e r_K e y $ = CHR$ ( 255 ) 6: " E " 

110 P r i n t a 11 _K e y $ = CHR$ ( 255 ) & " A " 

120 ! 

130 OUTPUT 2;Printall_Key$5 ! Use "5" to suppress CR/LF. 

lao OUTPUT 2;"BEEP"&:Eriter_Key*; 

150 END 



Note 

Since this type of output can be used to send immediately executed 
commands (such as SCRATCH A) it is very important that you be 
very cautious when outputting commands to the keyboard. It is also 
advised that you use care when editing statements and commands 
sent to the keyboard due to the two-character non-ASCII key se- 
quences; unexpected results may occur when carelessly editing 
non-ASCII key sequences output by a progrann. 

The following table shows the resultant characters that follow CHR$(255) in the two-character 
sequences generated by these keystrokes. The table is included only to show the general 
mnemonic nature of the second character in these sequences. The next table can be used to 
look up which non-ASCII key is to be output if the second character is known. 
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Second Byte of Non-ASCII Key Sequences (String) 

Holding the CTRL key and pressing a non-ASCII key generates a two-character sequence on 
the CRT. The first character is an "inverse-video" K. This table can be used to look up the key 
that corresponds to the second character of the sequence. (On the small 98203A keyboard 
some non-ASCII keys generate ASCII characters when they are pressed while holding the 
CTRL key.) 



Character 


Value 


Key 


space 




1 


! 
tt 


33 
35 


( STOP ) 

1 


( CLRLN 1 


« 


36 


[ANY CHAR J 


7. 


37 


(CLR'ENDl 


e, 


38 


[SeleclJ 




39 


(Prev) 


( 


40 


(SHin)-( TAB ) 


) 


41 


( TAB ) 


# 


42 


[INS LN] 


+ 


43 


[ INS CHR ] 


t 


44 


(Next) 


- 


45 


( DEL CHR ] 


. 


46 


Ignored 


1 


47 


(DEL LN) 





48 


( ko ) 


1 


49 


( ki ) 


2 


50 


1 ka ) 


3 


51 


( k3 ) 


IX 


52 


( k4 ) 


5 


53 


nn 


B 


54 


( k6 ) 


7 


55 


( k7 ) 


8 


56 


( k, ) 


9 


57 


( k9 ) 


: 


58 


CSHIFTj-system[ « J= 


; 


59 


( SHIFT ) -svstem( \1 Y 


< 


60 


[ - ) 


= 


61 


( RESULT ) 


> 


62 


( - ) 


7 


63 


( RECALL ) 


@ 

B 


64 
65 
66 


( SHIFT )-( RECALL ] 


( PRT ALL ) 


( BACK SPACE ) 


C 


67 


( CONTINUE ) 


D 


68 


I EDIT ) 


E 
F 


69 

70 


[ENTERj 


(DISPLAY FCTNS) 


G 


71 


(SHIFT)-( - ) 


H 


72 


(SHin)-( - ) 


I 


73 


(CLR I/O) 


J 
K 


74 
75 


Katakana Mode 


( CLR SCR ) 


L 


76 


[ GRAPHICS ) 


M 
N 


77 
78 


(ALPHA) 


[DUMP GRAPHICS] 





79 


( DUMP ALPHA ) 



Character 


Value 


Key 


P 



R 


80 


(PAUSE) 

1 


82 


( RUN ) 


S 


83 


( STEP ) 


T 


84 


( SHIFT )-( 1 ) 


U 


85 


(CAPS LOCK) 


U 


86 


( 1 ) 


M 


87 


(SHin)-( t ) 


X 


88 


( EXECUTE ) 


Y 

[ 


89 
91 


Roman Mode 

1 


( CLR TAB ) 


\ 

: 


92 
93 


( r ) 


( Sr TAB ) 




94 


( I ) 


- 


95 


(SHIFT)-( r ) 
1 


^ 


97 


( k,o) 


b 


98 


( k„) 


c 


99 


( k,H 


d 


100 


( k,3) 


e 


101 


( k„) 


f 


102 


(Tin 


3 


103 


( k,6) 


h 


104 


( k,7) 


1 


105 


( k„) 


J 


106 


( ki9) 


K 


107 


( k20) 


1 


108 


( k2, 1 


III 


109 


( k22) 


n 


110 


( k23) 


a 


111 


[ SHIFT )-svstem( t\ ]- 


p 


112 


( SHIFT )-5VStem( fl Y 


1 


113 


[SHIRj-systemt n Y 


r 


114 


(SHin)-svstem( M Y 


5 


115 


( SHIFT )-user( t\ Y 


t 


116 


( SHIFT ) -user( ^2 )- 


U 


117 


(SHIR)-user( /3 Y 


1.1 


118 


LSHIFTj^userL M ]- 


u 


119 


( SHIFT ) ^useri ^5 Y 


X 


120 


( SHIFT ) -user( r6 )" 


'/ 


121 


(SHin)-uscr( n Y 


z 


122 


(SHIR)-user( n Y 


} 


123 


[System) 


1 


124 


(Menu) 


< 


125 


( User) 


; 


126 


[SHin)-(Menu) 

1 



1 These characters cannot be generated by pressing the CTRL key and a non-ASCII key. If one of these characters follows CHR$(255) in an 

output to the keyboard, an error is reported (Er ro r 131 Bad non-alphanumeric Keccode.l- 
^ System and user refer to the softkey menu which is currently active. 
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Closure Keys 

Several of the non-ASCII keys are known as "closure keys". Closure keys are so named 
because of the way the computer processes these keys when output to the keyboard. The 
important feature of closure keys is that the computer can only process two closure keys 
between program lines during a running program. If more than two appear in the data 
output to the keyboard, the additional keys may be processed in an unexpected order. 

As an example, the following program sends four closure keys to the keyboard with a single 
OUTPUT statement. Only the first two closure keys are processed after this OUTPUT state- 
ment (but before D I SP "Next BASIC 1 i n e " is executed). The third and fourth closure 
keys are processed after D I S P "Next BASIC line" is executed (but before D I S P "2nd 
BASIC line" is executed). This accounts for the following display after running the program, 
since the "Printall" command was not executed until after D ISP "Next BASIC line" was 
executed. 



IOC 
lie 
IZC 
13(: 

lac 

ISC 
IBC 
17C 
18C 
19C 
2 C 
21C 

23C 
2U( 
25 C 
2BC 
27C 



! Define n on -ASCI I 
En$ = CHR$(255)6:"E" ! 
Up$ = CHR$(255)&:"-" ! 
Prt$ = CHR$(255)6:"A" ! 



K e y s . 

ENTER or Return Key. 

Up arrow k e >' . 

PRT ALL Key or soft Key 



CONTROL 2 »1 ;0 
CONTROL 1 »1 ;i 
OUTPUT 1 ;"Line 



! Turn PRINTALL off, 
! B e S i n on top screen 



line* 



1 ; " L i n e 
1 ; " L i n e 



1" 
3" 



OUTPUT 
OUTPUT 
IaIAIT 1 

I 

! Now send statement w i t in 4 closure K e y s . 

OUTPUT 2;"DISP ""Hello ! En$ ; Up$ 5 Up$ ! P r t $ ; 

DISP "Next BASIC line" ! PRT ALL still off. 



DISP "2nd BASIC line 



END 



! Now PRT ALL is on. 
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Display After Running Program 



Line 3 
2nd BASIC 



line 



2nd BASIC line 



P r i n I a 1 1 on 



In addition, if the last character sent to the keyboard is a CHR$(255), the next character typed 
in by the user will give unexpected results. Again, it is important to exercise care when using this 
feature. 



Softkeys 

The keys on the upper-left portion of the keyboard are called "softkeys." These keys can be 
defined by BASIC programs to initiate program branches. These keys can be defined as 
typing-aid keys, which produce keystrokes just as if you had typed them in yourself. 

Brief examples of using the softkeys have already been presented in Chapter 7 and in earlier in 
this chapter ( see "Modifying the Repeat and Delay Intervals"). Typing-aid keys are discussed 
in Chapter 2 of BASIC Programming Techniques; softkeys are also briefly described in Chapter 
3 of the same manual. 
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Sensing Knob Rotation 

Your computer system may, or may not, have a knob (built-in, or HP 46083) or a mouse (HP 
46060). In any event, the programs below are illustrative. It is assumed that you will use the 
techniques and apply them to your programming situation. 

The "event" of the knob (rotary pulse generator) being rotated can be sensed by the program. 
The branch location, interval at which the computer interrogates the knob for the occurrence of 
rotation, and branch priority are set up with a statement such as the following. 

ON KNOB Inte rual tPrio rity CALL Kno b_t u rn e d 

In addition to the program being able to sense rotations of the knob, it ca n also det ermine how 
many pulses the knob has produced and whether or not either or both of the ( CTRL ) or [ SHIF ] keys 
are being pressed'. This ability to "qualify" the use of the knob allows it to be used for up to four 
different purposes. The following program shows how to set up the branch, how to determine the 
number of pulses, and how to determine the direction of rotation. 

100 ON KNOB .25 GOSUB Knob ! Check Knob euerv 1/a sec. 

110 ! 

120 FOR Iteratiori = l TO 400 

130 WAIT .2 

lao DISP Iteration 

150 NEXT Iteration 

ISO ! 

170 STOP 

180 ! 

190 Knob: STATUS 2 » 1 ;K e y _w i t h_Kn o b 

200 PRINT KNOBKi" pulses "; KNOBY;" pulses "! 

210 IF Key-wi th_Knob=0 THEN 

220 PRINT ! CR/LF, 

230 ELSE 

240 IF Key_with_Knob=l THEN PRINT "with SHIFT" 

250 IF Key_with_Knob=2 THEN PRINT "with CTRL" 

2G0 IF Key_with_Knob=3 THEN PRINT "with SHIFT and 

CTRL" 
270 END IF 
280 RETURN 
290 END 



If any pulses have occurred since the last interrogation, the specified branch will be initiated. 



1 HIL devices do not set the "CTRL" bit, although they do set the "SHIFT" bit (if the last record processed was "y-axis" data). Consequently, 
you should not depend on the value of keyboard status register 10. 
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One full rotation of the built-in knob produces 120 pulses. The service routine calls the KNOBX and 
KNOBY functions to determine how many pulses (only net rotation) have been generated since 
the last call to this function. If the number is positive, a net clockwise rotation has occurred; a 
negative number signifies that a net counterclockwise rotation has occurred. Since the pulse coun- 
ter (on built-in knobs) can only sense -I- 128 to - 127 pulses during the specified interval', the 
interval parameter should be chosen small enough to interrogate the knob before the pulse counter 
reaches one of these values. Experiment with this parameter to adjust it for your particular applica- 
tion. 

The next program illustrates use of an ON KNOB statement with a mouse. Note changes in 
iteration as you move the mouse. 



10 


COM /Knob/ Kx>Ky 


20 


Kx = 


30 


Ky = 


40 


ON KNOB 1 CALL Knob 


50 


PRINT TABXY(1»1);" " 


60 


FOR 1=1 TO l.E+6 


70 


DISP I 


80 


PRINT TABXY(1.2);KxiKy;" 


90 


NEXT I 


100 


END 


110 


SUB Knob 


120 


COM /Knob/ Kx »Ky 


130 


INTEGER KnxtKny 


140 


Knx=KNOBX 


150 


Kny=KNOBY 


IBO 


Kx = Kx + Krix 


170 


Ky=Ky+Kny 


180 


PRINT TABXY( 1 »5) iKnx !Kny !" 


130 


SUBEND 



You can also trap mouse keys with ON KBD and KBD$ function (see the su bsequ e nt sec ti on for 
details on using these keywords). The keys produce the same codes as the ( Shift )( /1 ] , ( Shift ) 
( /2 ] . etc. keys on HIL keyboards. 



Note 

If you have programs written in BASIC 2.0/2.1, refer to the Knob 
section in Chapter 15 of the BASIC 3.0 Programming Techniques 
manual for more information. 



1 HIL devices can count from 32 767 to - 32 768 pulses during the interval. 
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Enhanced Keyboard Control 



Normally, the BASIC operating system handles all keyboard inputs. Several BASIC statements 
allow programs to handle inputs from the keyboard; examples are the INPUT, LINPUT, EN- 
TER, ON KEY, and ON KNOB statements. Additional keyboard statements provide BASIC 
programs with a means of intercepting both ASCII and non-ASCII keystrokes for processing by 
the program. The statements are: 



ON KBD 



sets up and enables keystrokes to be trapped. 



DNKBD»ALL includes (PAUSE) , ( STOP ) , (CLR I/O) , and softkeys. 
K B D $ returns keystrokes trapped in the buffer. 



OFF KBD 



resumes normal keystroke processing. 



ON KBD allows terminal emulation, keyboard masking, and special data inputs. Each keystroke 
produces unique code(s) that allow the program to dif ferent iate between different keys being 
pressed. The program can also determine whether the ( SHIFT ) or ( CTRL ) keys are being pressed 
with a particular key, but these keystrokes cannot be detected by themselves. Also, the (RESET) 
key cannot be trapped by ON KBD. 

Trapping Keystrokes 

The ON KBD statement sets up a branch that is initiated when the keyboard buffer becomes 
"non-empty". The service routine may then interrogate the buffer as desired, processing the 
keystrokes as determined by the program. The keyboard buffer of Series 200/300 computers 
contains up to two CRT lines. Calling the KBD$ function does two things: it returns all keystrokes 
trapped since the last time the buffer was read, and it then clears the keyboard buffer. 

The following program uses ON KBD, KBD$, and OFF KBD to trap and process keystrokes, 
rather than allowing the operating system to do the same. The program defines each keystroke 
to print a complete word. 



IOC 

lie 

12C 
IGC 

lac 

IBC 

lec 

17C 
IBC 
19C 
2 
210 



OPTION BASE 1 
DIM St rin^$(2B) [G] 
READ StrinS$(*) 
! 

DATA 
DATA 
DATA 
DATA 
! 

PRINTER IS 1 
PRINT "Many ASCII 
PRINT "defined to 
PRINT 



A , BROWN ,CAT »DOG ,E>(IT »FOX tGOT 

HI ,IN »JUMPS fKICKED »LAZY »MY 

NO .0'.'ER tPUSHED , QUICK »RED »SMART 

THE .UNDER .UERY .WHERE .XRAY .YES .ZOO 



K B y 5 ha u e been 
produce words. 
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230 
240 
250 
2B0 
270 
280 
290 
3 
310 
320 
330 
340 
350 
3G0 
370 
380 
390 

aoo 
a 10 

420 

430 

440 

450 

4G0 

470 

480 

490 

500 

510 

520 

530 

540 

550 

580 

570 

580 

590 

BOO 

810 

820 

830 

840 

850 

880 

870 

880 

890 

700 

710 



PRINT "Press the followinS ke/s," 
PRINT "T Q B F J T L D ." 

I 

ON KBD GOSUB Process-Kevs 

! 

LOOP 

EXIT IF Word$="E>(IT" 
END LOOP 
! 

STOP 
! 

Process-Kevs: Kev'$ = KBD$ ! Read buffer. 
! 

REPEAT ! Process ALL kevs trapped. 
Key_code=NUM(Key$Cl 51] ) 



SELECT Key_code 
! 

CASE 85 TO 90 

|Alord$ = Striri3$(Key_co 

Key*=Key$C2] 

! 

CASE 97 TO 122 

Word* = Striri3$(Key_c 

Key*=Key$C2] 

! 

CASE 255 



IF Key*[2;i3<>CHR$(255) THEN 



Nord$=Key$Cl »2] 
Key$=Key$C3] 

ELSE 

iAlord* = Key$[l >3] 
K e y * = K e y $ [ 4 ] 

END IF 
CASE ELSE 

Word$="" 

Key$=Key$[2] 

! 

END SELECT 
I 

Def ined = LEN( Wo rd$)< >0 
IF Defined THEN 

PRINT Word$;" " ; 

DISP 
ELSE 

BEEP 100».05 

DISP "Key undefined 
END IF 



Calculate code. 

Choose response. 

CASE "A" TO "Z" ♦ 
de-84) 
R e m u e processed Key. 



de-98) 
R e w u e processed Key. 

CASE n on -ASCI I Key. 



Non-ASCI I Key alone » 
so taKe 2 codes. 

Non-ASCII w/ CTRLt 
so take 3 codes. 

CASE all others. 

Remoye processed Key. 



! Execute response. 
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720 


1 








730 


UNTIL LEN(Key$)=0 


! Until 


ALL 


Keys processed* 


740 


! 








750 


RETURN 








7G0 


! 








770 


Quit: END 









Notice that all non-ASCII keys produ ce two-character sequences; CHR$(255) followed by an 
ASCII character. Pressing the ( CTRL ) key with non-ASCII keys produce three-character sequ- 
ences: another CHR$(255) character preceding the two-character sequence produced by 
pressing the non-ASCII key by itself. See the tables in "Outputs to the Keyboard" for a listing of 
the sequences produced by non-ASCII keys. 

BASIC programs can output ASCII keystrokes to the keyboard, via D U T P U T 2, without initiat- 
ing an ON KBD branch; however, outputting non-ASCII "closure" keys will initiate the ON 
KBD branch. For example, executing the following statement (in a program line): 

OUTPUT 2 5 "32*2" ;CHR$(255) ;"E" T'KBD" 5 

causes the characters KBD which follow the closur e key to be placed in the K BD$ bu ffer, which 
also initiates the ON KBD branch. The ( EXECUTE j -key (or equivalent such as ( Return ) ) sequence 
which was sent to the keyboard executes the numeric expression 32*2 before the branch is 
initiated. This type of operation may result in unpredictable results and is therefore not recom- 
mended while ON KBD is in effect. 

ON KBD branching is disabled by DISABLE, deactivated by OFF KBD, and temporarily deacti- 
vated when the program is executing LINPUT, INPUT, or ENTER 2 statements. 

Mouse Keys 

You can also trap mouse keys with this technique. The keys produce CHR$ (255) followed by 
"s", "t", and so forth. 

Softkeys and Knob Rotation 

When ON KNOB is not in effect, knob rotation is also trapped by ON KBD. Rotation will 
produce the "cursor" keystrokes; clockwise rotation produces CHR$(255)foIlowed by "'", 
while counter-clockwise rotation produces CHR$(255) followed by "M". 

ON KBD>ALL allows softkey trapping ("overrides" ON KEY) but does not change the softkey 
labels. 

Disabling Interactive Keyboard 

Another group of statements is used to disable the interactive keyboard functions: 



SUSPEND INTERACTIVE ignores the (^AUSE) , fsfOPl . ( STEP ) . and. [CLR I/O) 

keys and disables live keyboard execution. 



SUSPEND INTERACTIVE , RESET ignores fRESET) too. 

RESUME INTERACTIVE returns to normal operation 

SUSPEND INTERACTIVE can be used to prevent interruption of programs which gather data 
or which control other systems. 
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Special care should be taken when using SUSPEND INTERACTiyE»RESET. Ifan' 'infinite 
loop" is executed while interactive keyboard functions are disabled, only the power switch will 
stop execution of the program. 



110 
120 
130 

lao 

150 
ISO 
170 
180 
ISO 
200 
210 
220 
230 
240 
250 
280 
270 
280 
290 
300 
310 
320 



! This pro^raw cannot be stopped bv 

! PAUSE* STOP* OR RESET 

! before its normal completion 



SUSPEND INTERACTIVE »RESET ! ignore Keyboard 

! 

PRINT "COUNTDOWN IS " 

PRINT 

1 = 10 

REPEAT 

PRINT " T minus "51 

1 = 1-1 

WAIT 1 
UNTIL KO 



! Initial value. 

Print count. 
Decrement count. 
Wait one second. 



I 

PRINT 

BEEP 100 »1 

PRINT "Done" 

RESUME INTERACTIVE 

I 

END 



! Retu rn to no rmal . 
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Locking Out the Keyboard 

There are certain times during program execution when it is expedient to prevent the operator 
from using the keyboard, such as during a critical experiment which cannot be disturbed. Then 
the knob and groups of keyboard keys can be enabled and disabled separately. 



Setting bit of register 7 (of interface select code 2) disables all keys (excluding the [ RESET) key) 
and the knob. The following program I'irst sets up the KNOB and KEY events to initiate program 
branches. It is assumed that the keyboard is already enabled; if you are not sure, press the ( RESET) 
key. When the program is run, the keyboard and knob remain enabled for about five seconds, after 
which they are disabled. The pr ogram then displays the time of day indefinitely; the only way to 
stop the program is to press the ( RESET) key. 



10 
11 
12 
13 

la 

15 
IS 
17 
18 
19 
20 
21 

t-y ry 

23 
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25 

2E 

27 
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30 

31 

32 

33' 

34' 



ON KEY LABEL "SFK 0" GOSUB KevO 

ON KNOB .2 GOSUB Knob 
! 

PRINT "You'ue Sot 5 seconds, GO! " 

FOR Iteration=l TO 20 

WAIT .25 

NEXT Iteration 
! 

Re5et_di5able=0 ! RESET remains ENABLED. 

Ky_Knb_disable=l ! DISABLE rest of Kbd. 

CONTROL 2 » 7 ; 2*R e s e t _ d i 5 a b 1 e + K y _ K n b _ d i s a b 1 e 

PRINT "Time's up!" 

BEEP 

! 

SET TIME 
Loop: DISP DROUND ( TI MEDATE MOD ( 24*B0*G0 . ) ,4 ) 
GOTO Loop 
! 

! 
K e y : PRINT "Special function Key pressed, 
RETURN 
I 

Knob: PRINT "Knob rotation sensed," 
RETURN 
END 



If the value of the variable Rese1_disable is set to 1 in the preceding program, the only way to 
prematurely stop the program is to turn off power to the computer, losing the program and all data 
currently in computer memory. 



Note 



Use care when locking out both the [ RESET) key and the keyboard 
keys. If both are locked out, the only way to prematurely stop the 
program is to turn the computer off. 
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Keyboard Status and Control Registers 



Status Register 
Control Register 

Status Register 1 
Control Register 1 

Status Register 2 
Control Register 2 

Status Register 3 
Control Register 3 



Status Register 4 
Control Register 4 

Status Register 5 

Control Register 5 
Status Register 6 

Control Register 6 
Status Register 7 

Most Significant Bit 



CAPS LOCK flag 

Set CAPS LOCK if non-0 

PRINTALL flag 

Set PRINTALL if non-0 



Function key menu. 
Function key menu. 

Undefined 



= System menu 
1-3 = User menu 1 thru 3 



Set auto-repeat interval. If 1 thru 255, repeat rate in milliseconds is 10 
times this value. 256 = turn off auto-repeat. (Default at power-on or 
SCRATCH A is 80 ms.) 

Undefined 

Set delay before auto-repeat. If 1 thru 256, delay in milliseconds is 10 
times this value. (Default at power-on or SCRATCH A is 700 ms.) 



KBD$ buffer overflow register. 
Register is reset when read. 
Undefined 



overflow. 



Typing aid expansion overflow register. 
1 — overflow. Register is reset when read. 

Undefined 



Interrupt Status 

Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 











INITIALIZE 
Timeout 
Interrupt 
Disabled 


Reserved 

For Future 

Use 


Reserved 

For Future 

Use 


RESET 

Key 
Interrupt 
Disabled 


Keyboard 
and Knob 
Interrupt 
Disabled 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 7 (Set bit to disable) 

Most Significant Bit 




Interrupt Disable Mask 

Least Significant Bit 


Bit? 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Not Used 


INITIALIZE 
Timeout 


Reserved 

For Future 

Use 


Reserved 

For Future 

Use 


RESET 
Key 


Keyboard 
and Knob 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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Keyboard Status and Control Registers (cont. 

Status Register 8 Keyboard language jumper 



) 



Control Register 8 
Status Register 9 



- US ASCII 


7- 


- United Kingdom 


13- 


- Swiss German 


1 - French 


8- 


- Canadian French 


14- 


- Latin (Spanish) 


2 - German 


9- 


- Swiss French 


15- 


- Danish 


3 - Swedish 


10- 


- Italian 


16- 


- Finnish 


4 - Spanish 


11- 


- Belgian 


17- 


- Norwegian 


5 - Katakana 


12- 


- Dutch 


18- 


- Swiss French* 


6 - Canadian English 






19- 


- Swiss German* 


Undefined 











Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Internal 
Use 


Internal 
Use 


1=HP46020A 
Keyboard 

O = 0ttier 
Keyboard 


1=No 

Keyboard 
= Keyboard 

Present 


1=n-Key 

Rollover 
= 2 or less 

Key Rollover 








1=HP98203A 
Keyboard 

O = 0ttier 
Keyboard 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value - 4 


Value = 2 


Value = 1 



Control Register 9 
Status Register 10 



Undefined 



State at Last Knob Interrupt 



Most Significant 


Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 




















CTRL 

Key 

Pressed 


SHIFT 

Key 
Pressed 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value -8 


Value - 4 


Value = 2 


Value = 1 
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Keyboard Status and Control Registers (cont.) 

Control Register 10 Undefined 

= horizontal-pulse mode; 1 = all-pulse mode 



Status Register 11 
Control Register 11 



Status Register 12 
Control Register 12 

Status Register 13 
Control Register 13 

Status Register 14 
Control Register 14 



(default is without KNB2_0 loaded, 1 with KNB2_0 loaded). Refer 
to the Knob section in Chapter 15 of the BASIC Programming Tech- 
niques manual for more information. 

"Pseudo-EOI forCTRL-E" flag 

Enable pseudo-EOI for CTRL-E if non-0 

Katakana flag 

Set Katakana if non-0 

Function keys on HP 46020A software key numbers shifted. 
Function keys on HP 46020A software key numbers shifted. 

= ( n ) is Key 1; default 

1 = [ n ] is Key 



Status Register 15 Return keyboard compatibility mode (0-»off, 1— *on). 



Control Register 15 



Turns Model 236 keyboard compatibility mode on (=^0) and off ( = 0). 
(See the chapter "Porting to Series 300" in the Programming Techni- 
ques manual) 
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I/O Path Attributes 



Chapter 



10 



This chapter contains two major topics, both of which involve additional features provided by 
I/O path names. The first topic is that I/O path names can be given attributes which control the 
way that the system handles the data sent and received through the I/O path. Attributes are 
available for such purposes as controlling data representations, generating and checking parity, 
and defining special end-of-line (EOL) sequences. 

The second topic is that the same I/O statements' can be used to access most system resources, 
including the CRT, keyboard, mass storage files, and buffers (rather than using a separate set of 
BASIC statements for each type of resource). This second topic, herein called "unified I/O," 
may be considered an implicit attribute of I/O paths. 



The Format Attributes 

All I/O paths used as means to move data have certain attributes; the general attributes of a 
particular I/O path consist of both hardware and software characteristics. However, the attri- 
bute of interest in this discussion is that of data format, or how the computer represents the 
data it sends and how it interprets the data it receives through I/O paths. 

All I/O paths possess either the FORMAT ON or the FORMAT OFF attribute. If an I/O path 
possesses the FORMAT ON attribute, the ASCII data representation is used.' If the I/O path 
possesses the FORMAT OFF attribute, the computer's internal data representation is used. This 
section first describes how the FORMAT ON attribute is automatically assigned to I/O paths to 
devices and then shows how to assign the FORMAT OFF attribute to I/O paths. The actual 
internal representations are described in "The Format Off Attribute". 



1 The ASCII data representation used when an I/O path possesses the FORMAT ON attribute was fully described in Chapters 4 and 5. 



146 I/O Path Attributes 



The Format On Attribute 

Names are assigned to I/O paths between the computer and devices with the ASSIGN state- 
ment. A typical example is shown below. 

110 ASSIGN @Ariy_nawe TO Deu i c e_5 e I ec t o r 

As you know from Chapter 3, this assignment fills a fixed amount of memory space with 
information describing the I/O path between the specified device and the computer. This 
information includes the device selector, the FORMAT attribute possessed by the path, and 
other relevant information. When the I/O path name is specified in subsequent ENTER and 
OUTPUT statements, this information adequately describes the I/O path to be used. 

Since most devices use an ASCII data representation, the default attribute automatically 
assigned to the I/O path between the computer and devices is FORMAT ON; this is also the 
default for buffers. When an I/O path possesses this attribute, the ASCII data representation is 
automatically used by the computer when executing the OUTPUT and ENTER statements. 
Data output from the computer is "formatted" into an ASCII representation, and data entered 
into the computer is interpreted as ASCII and then converted back into its internal representa- 
tion. The following diagram pictorially describes these operations. 



Computer 
Memory 



Internal-Form Data 



c 



> 



ASCII 

'Formatter" 

Routine 



ASCII Data 



A 
V 



^ 



Computer 
Resource 



The FORMAT ON Attribute Requires Data To Be Formatted 

Data items moved through I/O paths which possess this attribute are formatted by operating- 
system firmware. This formatting process takes a finite amount of time for each data item to 
be moved, but is required for data compatibility when communicating with devices which use 
this data representation. Contrast the preceding diagram to the following diagram which 
shows data being moved through an I/O path possessing the FORMAT OFF attribute. 



Computer 
Memory 



Internal-Form Data 



C=^ 



Computer 
Resource 



The Internal Data Representation Is Maintained with FORMAT OFF 

Using the internal data representation during communication does not require the additional 
formatting time taken when the ASCII representation is used. However, the device must also 
use the internal data representation. 
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One of the most powerful features of an I/O path is that its FORMAT attribute can be 
changed from BASIC programs. The next section describes specifying the FORMAT attri- 
bute and describes outputting and entering data through an I/O path which possesses the 
FORMAT OFF attribute. 

Specifying I/O Path Attributes 

There are two methods of explicitly specifying attributes. The first is to specify the desired 
attribute when the name is initially assigned to the resource, as shown below. Either the 
default FORMAT attribute or the alternate FORMAT attribute may be specified, as required 
for the application. 

Example of Initially Assigning an Attribute 

100 ASSIGN iDeuice TO Deu.se 1 ec t o r iFDRMAT OFF 
100 ASSIGN @Deuice TO I n t-se 1 _cod e ;F0RMAT ON 

Example of Changing an Attribute 

The second method allows you to change only the attribute currently assigned to the I/O 
path. As a result, the "TO resource" portion of the ASSIGN statement is not necessary; 
however, the I/O path name must currently be assigned in this context, or an error is reported. 

200 ASSIGN @Deuioe JFORMAT OFF ! Assign only the attribute. 

The result of executing this statement is to modify the entry in the I/0-path-name table that 
describes which FORMAT attribute is currently assigned to this I/O path. The implicit 
"ASSIGN eOeuice TO *", which is automatically executed when the "TO resource" 
portion is included, is not executed. Also, the I/O path name must currently be assigned (in 
this context) to an I/O path, or an error results. 

Example of Restoring the Default Format Attribute 

If any attribute is specified, the corresponding entry in the I/0-path-name table is changed (as 
above); no other attributes are affected. If no attribute is explicitly specified (as below), all 
attributes (except WORD) are changed to their default state (such as FORMAT ON for devices). 

340 ASSIGN SDevice ! Restores the default attributes. 

The Format Off Attribute 

Chapter 2 briefly described the internal data representations used for both computations and 
data storage. These internal representations are also used when moving data through I/O 
paths that possess the FORMAT OFF attribute. Since this chapter has already described how 
to assign the FORMAT OFF attribute to I/O paths, the only remaining information needed is a 
description of the actual FORMAT OFF (internal) data representations. 
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Notice that, in all cases, when an I/O path has been assigned the FORMAT OFF attribute: 

• no item terminator and no EOL sequence are sent by the OUTPUT statement. 

• no item terminator and no statement-termination condition are required by the ENTER 
statement. 

• if either an OUTPUT or an ENTER statement uses an image, the FORMAT ON attribute is 
automatically used. 

• no non-default CONVERT or F'ARITY attribute may be assigned to the I/O path (see 
subsequent sections). 

Compare this lack of terminators to those sent by the OUTPUT statement (and required by the 
ENTER statement) when using an I/O path possessing the FORMAT ON attribute (see Chapters 
4 and 5). The next section describes the rationale behind the design of the following internal 
representations. 

Integers 

Integers are internally represented by two bytes (one word) of data. When an integer is output, 
only two bytes are sent with no trailing item terminator; no EOL sequence follows the last item 
in the source list. The most significant byte is sent first (on an eight-bit interface). When an 
integer is entered, only two bytes are entered from the source, and no search for an item 
terminator or statement-termination condition is made. If the source does not send two bytes, a 
timeout may occur (if the event is set up on the interface involved)'. 

Real Numbers 

Real numbers are internally represented by eight bytes. When a real number is output, only 
eight bytes are sent with no trailing item terminator; no EOL sequence follows the last item of 
the source list. When a real number is entered, only eight bytes are entered, and no search is 
made for item terminators. If eight bytes are not sent by the source, a timeout may occur (if set 
up on the interface). 

String Data 

String-data items are internally represented by a two-byte, binary length header followed by the 
actual string characters. When a string is output, a four-byte length header (the first two bytes of 
which are zeros ) is output, most significant byte first, followed by the actual string characters. If 
the number of characters in the string is odd, a trailing space character (CHR$(32)) is sent to 
make an even number of characters. No trailing item terminator is output after the item, and no 
EOL sequence follows the last item in the source list. 

When string data is entered into a string variable, the first four bytes entered determine the 
number of characters that the computer will attempt to enter. The source is expected to send 
the specified number of characters, so there is no need to search for item terminator or state- 
ment-termination condition. If the string length is odd, the source must send an extra trailing 
byte to make an even number of characters. 



1 Timeout events are discussed in Chapter 7, "Interfaca Events" 
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If the length specified by the header is greater than the dimensioned length of the string 
variable, an error is reported (Error 18 String oufl» or substring err) and 
the string retains its former value. If the number of characters sent is less than that specified by 
the length header, an interface timeout may occur while the compute r is w aitin g for the last 
character(s]i to be sent by the source. If a timeout does occur (or if the [CLR I/O] or [ Break ) ) key is 
pressed before all characters have been received), the variable contains the characters that have 
been received. 



Additional Attributes 

The first section discussed the FORMAT attributes of I/O path names. Several other attributes 
are available, which can direct the BASIC system to perform the following functions whenever 
data are moved through the I/O path possessing the attribute: 

• specify that data are to be sent and received on a byte or word basis 

• perform conversions on a character-by-character basis on inbound and/or outbound data 

• check for parity on inbound data, and generate parity on outbound data 

• re-define the end-of-line sequence normally sent after the last data item in output opera- 
tions 

It is also possible to direct the system to return a numeric code to a variable which describes the 
outcome of an attempted ASSIGN operation. This section describes implementing these func- 
tions by using the additional I/O path attributes. 

The BYTE and WORD Attributes 

The HP Series 200 computers are capable of handling data as either 8-bit bytes or 16-bit words 
when using 16-bit interfaces. This section describes how to use the BYTE and WORD attributes 
to determine which way the system will handle data when using these interfaces. 

Unless otherwise specified, the system treats data as bytes during I/O operations. For 

instance, when the following I/O statement is executed: 

OUTPUT Deuice_selectornnte3er_array(*) 

the 16-bit INTEGER values are normally sent one byte at a time, with the most significant byte 
of each INTEGER sent first. Executing the following statement: 

OUTPUT Deuice-selector USING " W" ; In t e Se r_a r rav < * ) 

directs the system to send the data as words if the interface has the ability to handle data as 
words. With a 16-bit interface, such as the HP 98622 GPIO Interface, the INTEGER data are 
sent one word at a time (i.e., one word per handshake cycle). If the interface is not capable of 
sending one word in a single operation, the word is sent as two bytes with the most significant 
byte first. 
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When the BYTE attribute is assigned to an I/O path name, the system sends and receives all 
data through the I/O path as bytes; one byte is sent (or received) per operation. Thus, BYTE 
directs the system to treat a 16-bit interface as if it were an 8-bit interface. The following 
statements show examples of assigning the BYTE attribute to an I/O path: 

ASSIGN @Pr inter TD 701? BYTE 
ASSIGN SDeMice TO 12;BYTE 

In the first statement, the BYTE attribute is redundant, because the WORD attribute cannot be 
assigned to the HP-IB Interface (since it is an 8-bit interface). 

When the I/O path name assigned to an interface possesses the BYTE attribute, the system 
sends and receives all subsequent data through the interface one byte per handshake opera- 
tion. As an example, executing either of the following statements (when the I/O path possesses 
the BYTE attribute): 

OUTPUT @Deuice 5 InteSe r._arra>' (*) 

OUTPUT iDeuice USING " W" Un t e Se r_a r ray ( * ) 

directs the system to send the data as bytes, even though the interface is capable of sending the 
data as words (and in the second example the "W" specifier was used). Stated again, the BYTE 
attribute directs the system to treat 16-bit interfaces as if they were 8-bit interfaces. With BYTE, 
only the 8 least significant bits of the interface are used to send and receive data; the most 
significant bits are always zeros. Keep in mind that the logic sense of the signal lines used to 
send and receive these bits is determined by switch settings on the interface card. 

The WORD attribute specifies that all data sent and received through the I/O path are to be 
moved as words. In other words, this attribute directs the system to use all 16 data lines of a 
16-bit interface for all subsequent I/O operations that use the I/O path name. This attribute is 
designed to improve performance in two types of situations (on 16-bit interfaces): when send- 
ing and receiving FORMAT OFF data, and when sending and receiving INTEGERS with FOR- 
MAT ON. The WORD attribute can also be used under other situations; however, results may 
show some unexpected "side effects," which are explained later in this section. The interface to 
which the I/O path name is assigned must be capable of handling data words; if not, an error 
will be reported when the ASSIGN is executed. 

When an I/O path possesses the WORD attribute, an even number of data bytes will always be 
sent or received by any one I/O statement that uses the I/O path. Consequently, when an 
operation involves an odd number of data bytes, the system will place pad byte(s) in outbound 
data or enter (but ignore) additional byte(s) of inbound data. These operations can be thought 
of as "aligning data on word boundciries." This is the main side effect that can occur with the 
WORD attribute. 

With the FORMAT OFF attribute, all data items are represented by an even number of bytes 
(see the discussion in "The FORMAT OFF Attributes" earlier in this chapter for details). Since 
these representations use an even number of bytes, no pad bytes are necessary. 
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When WORD is used with FORMAT ON, the data will be buffered (automatically by the 
system) when necessary to allow sending all data as words. Sending INTEGERS does not 
usually require this type of buffering, because each INTEGER consists of two bytes of data. 
However, sending strings of odd length often requires that the system perform this automatic 
buffering. The first byte of each word is placed in a two-character buffer (created by the 
system); when the second byte is placed in this buffer, the two bytes are sent as one word, with 
the most significant eight bits representing the first byte. If an odd number of data bytes would 
otherwise be sent, a Null character, CHR$(0), is placed in the buffer to "flush" the last byte. 

The following statements show assigning the WORD attribute and using the I/O path to send 
data through the GPIO Interface at select code 12. Remember that the default FORMAT 
attribute assigned to I/O paths to devices is FORMAT ON. 



110 ASSIGN @Gpio TO 12;W0RD 

120 OUTPUT @Gpio T'Odd" 

130 OUTPUT iGpio USING "K»LtK"5"0dd 



»"Eueri" 



The following diagrams show the characters that would be sent by the OUTPUT statements in 
lines 120 and 130, respectively. 
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d 


CR 


LF 


NUL 



Word 1 Word 2 Word 3 






d 


d 


CR 


LF 


NUL 


E 


V 
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n 


CR 


LF 



Word 1 Word 2 Word 3 Word 4 Word 5 Word 6 



In the first statement, a Null was sent after the EOL characters to flush the buffer and force word 
alignment for a subsequent OUTPUT. The second statement shows that a pad byte will be sent 
after any EOL sequence when required to achieve word alignment; the Null pad byte was not 
needed after the second EOL sequence. In addition, if a buffer or file pointer currently has an 
odd value, a leading pad byte will be output to force word alignment before any data are sent 
by the OUTPUT statement. 

When executing an ENTER statement from an I/O path with the WORD attribute, the system 
always reads an even number of bytes from the source device, since data are sent as words. In 
cases where an odd number of data bytes are sent, such as when an odd number of string 
characters are sent with an even number of statement-terminator characters, the system enters 
(but ignores) the last byte sent (after the statement-terminator characters). The following state- 
ments show an example of entering the data sent by the OUTPUT statements in the preceding 
example. 

ASSIGN @Deuice TO 12;W0RD 
ENTEF? SDeuice ;St ririS_uarl$ 
ENTEF? @Deuice iSt rin jr_uar2* 
ENTEF? @Device ;St riri3_uar3* 
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The variables receive the following values: 

St riri^_uarl$="Odd" 
St riri^_i.)ar2$="0dcl" 
S t r i n S _ ij a r 3 $ = " E i.J e n " 

Notice that three ENTER statements were used to enter the data sent by the two preceding 
OUTPUT statements. This method was used to handle the pad bytes generated by the OUT- 
PUT statement. If two ENTER statements would have been used, the pad byte sent after the 
second "Odd" and EOL sequence would have to have been skipped by an "X" image speci- 
fier. The following ENTER statements show how this could be done. 

ENTER @Deuice USING " K »)•( >K " 5 St r i n 3_i.i a r 1 * >St r i n 3_i.) a r2$ 
ENTER iDeuice USING " K " 5 St r i n ^.m a r3$ 

If the "X" specifier would not have been used, a pad byte would have been placed in 
St r i n 3_ u a r2$. Thus, a general recommendation for entering data OUTPUT through an I/O 
path with the WORD and FORMAT ON attributes is to enter only one item per ENTER 
statement. 

When the WORD attribute is in effect, the "W" image specifier sends data that are always 
aligned on word boundaries. For instance, the following statement shows how the system 
defines "W" with the WORD attribute during OUTPUT. 

OUTPUT @Deuice USING " B » W " 5 B5 *25B*BB + G7 

\~A |nul| b I c I cr I lf 



Word 1 Word 2 Word 3 

The Null pad byte was sent before the "W" image data to align the INTEGER specified by the 
"W" on a word boundary. 

During ENTER, a pad byte is entered (but Ignored) when necessary to align the "W" item on a 
word boundary. For instance, the following statement would enter the preceding data items in 
the same manner as they were sent. 

ENTER UDeuice USING " B i W " iOn e_b y t e >Ori e_wo rd 

Keep in mind that these examples have been provided only to show potential problems that can 
arise when sending an odd number of data bytes while using the WORD attribute. It would be 
more appropriate to use only images that send an even number of bytes when using WORD 
during OUTPUT, and it will simplify matters to send only one item per OUTPUT statement. 
Similarly, it is generally much simpler if only one item is entered per ENTER statement. 
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Furthermore, if pad bytes pose a problem when working with INTEGER data (with FORMAT 
ON), you can also use the "Y" specifier. During OUTPUT, the "Y" does not force word 
alignment by sending a pad byte; during ENTER, the "Y" does not skip a byte to achieve word 
alignment. 

Note also that the Null character pad byte may be converted to another character by using the 
CONVERT attribute; see the next section for further details. 

The BYTE and WORD attributes affect any ENTER, OUTPUT, or TRANSFER statements that 
use the I/O path name. However, only the attribute specified on the non-buffer I/O path end of 
the TRANSFER is used; BYTE or WORD is ignored on the buffer end. 

Unlike other attributes, the BYTE and WORD attribute cannot be changed once assigned to an 
I/O path name. For instance, executing: 

ASSIGN iPrinter TO 12 

implicitly assigns the BYTE attribute to ©Printer, since it is the default attribute. Executing the 
following statement results in error 600 (Alt ri but e cannot be modified): 

ASSIGN sprinter ;WORD 

The converse situation is true for the WORD attribute. Furthermore, if WORD has been 
assigned to the I/O path, then BYTE is not restored when ASSIGN SDeuiceis executed; all 
other default attributes would be restored. For instance, executing: 

ASSIGN iDeuice TO 12 5 WORD »FORMAT OFF 

assigns the specified non-default attributes to the I/O path name ©Device. Executing: 

ASSIGN iDeuice 

restores the default attribute of FORMAT ON (and also other default attributes, if currently 
non-default), but it does not restore the default BYTE attribute. 
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Converting Characters 

The CONVERT attribute is used to specify a character-conversion table which is to be used for 
OUTPUT or ENTER operations. If data are to be converted in both directions, a separate 
conversion table must be defined for each direction. Two conversion methods are available — 
by index and by pairs. This section shows simple examples of each. 

CONVERT.. .BY INDEX specifies that each original character's code is used to index a replace- 
ment character in the specified conversion string. For instance, CHR$(10) is replaced by the 
10th character in the conversion string. The only exception is that CHR$(0) will be replaced by 
the 256th character in the conversion string. If the string contains less than 256 characters, 
characters with codes that do not index a conversion-string character will not be converted. If 
the string contains more than 256 characters, error 18 is reported. 

The following program shows an example of setting up a conversion by index for OUTPUT 
operations. 

100 DIM CoriM_st nn 3*C25G] 

110 INTEGER Iridex_ual 

120 ! 

130 ! Generate conyersion strins. 

lao FDR Index_ual=l TO 255 

150 SELECT Iridex_ual 

IBO CASE NUI1("a") TO NUMC'z") ! ChanSe to uppercase. 

1"^0 Conv_st rinS*C Ii-idex_ual ]=UPC*(CHR*( In de x_ij a 1 ) ) 

180 CASE ELSE ! No conuersiDn. 

190 Corii.i_st rinS*CIndex_i.'an=CHR*(Index_ual ) 

200 END SELECT 

210 NEXT Index_ual 

220 Coni.i_st rinS$C25B]=CHR$(0) ! 25Gth element has an 

^■^^-' ! e f f e c t i u e i n d e X f . 

240 ! 

250 ! Set UP conversions. 

2G0 ASSIGN @Dei.iice TO i;CONUERT OUT BY INDEX Conu_5trin3$ 

270 ! 

280 OUTPUT eDe.,.ice ;"UPPERCASE LETTERS ARE NOT CONCERTED." 

230 OUTPUT @Dei.i i ce i "Lowe rcase letters are conMerted." 

300 OUTPUT li"Con versions are made only " 

310 OUTPUT i;"uhen the I/O path is used." 

320 ! 

330 END 

The program is designed to convert lowercase characters to uppercase characters. In order to 
make the conversion, the program first computes the characters in the conversion string; the 
characters are computed one at a time. If the character's original code is not in the range 97 to 
122 ("a" to "z"), then no change is made. If it is in the range, an uppercase character is placed 
in the string at the location indexed by the original (lowercase character's) code. 

The example program's output is as follows. 

UPPERCASE LETTERS ARE NOT CONUERTED. 
LOWERCASE LETTERS ARE CDNUERTED. 
C n M e r 5 i n s are made only 
when the I/O path is used, 



I/O Path Attributes 155 



To perform the lowercase-to-uppercase conversion, it was not necessary to include characters 
with codes 123 through 255 in the conversion string, since these characters are not to be 
converted. They were included to emphasize that the 256th character must be included in the 
string if CHR$(0) is to be converted with this method. The CONVERT attribute is then assigned 
to the I/O path, and all subsequent data sent through the I/O path (while CONVERT is in effect) 
will be converted. 

CONVERT... BY PAIRS specifies that the conversion string contains pairs of characters, each 
pair consisting of an original character followed by its replacement character. Before each 
character is moved through the interface, the original characters in the conversion string (the 
odd characters) are searched for the character's occurrence. If the character is found, it will be 
replaced by the succeeding character in the conversion string; if it is not found, no conversion 
takes place. If duplicate original characters exist in the conversion string, only the first occurr- 
ence is used. The string variable must contain an even number of characters; if not, error 18 is 
reported. 

The following program shows an example of setting up the same conversion as in the preceding 
example, except that conversion by pairs is used. 

100 DIM Conv_st rini*C512] 

110 ! 

120 ! Define conuersion strinS. 

130 Conv_strin3*="aAbBcCdDeEfF3GhHiIJJKKlLmMnNo0pP" 

140 Conw_strin3*=Conu_strin9»&:"q0rR5BtTuUuywWxXyYzZ" 

150 ! 

ISO ! Set UP conversions. 

170 ASSIGN UDeuioe TO liCONMERT OUT BY PAIRS Conv_strinJ$ 

IBO ! 

190 OUTPUT eOeuice i"UPPERCABE LETTERS ARE NOT CDNMERTED . " 

200 OUTPUT SDey i ce i "Lowe rcase letters are converted." 

210 OUTPUT 1 i "Conwe rsions are made only " 

220 OUTPUT ir'uihen the I/O path is used." 

230 ! 

240 END 

The pairs method only requires that each character to be replaced (and its replacement) is 
included in the conversion string. Note that the first character of each pair is the original 
character and the second is the replacement. If a character does not appear in the conversion 
string, it will not be converted. 

Conversion of inbound characters can also be performed with both of these methods. In the 
second example, for instance, the conversion is implemented with the following statement. 

ASSIGN iDeyice JCQNUERT IN BY PAIRS Conu_strin^$ 

Conversions in both directions will continue until disabled. The following statement could be 
used to disable conversions of outbound data. 

ASSIGN eDeuice JCONUERT OUT OFF 
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It is important to note that the conversion string specified in the ASSIGN statement is used for 
each OUTPUT or ENTER statement that uses the I/O path while the conversion is enabled. 
Note that the conversion string's contents are not contained in the I/O path data type; only a 
pointer to the string variable is maintained. Thus, any changes to the string's value will im- 
mediately affect any subsequent OUTPUT or ENTER that uses that I/O path. 

It is also important to note that the string must be defined for at least as long as the I/O path 
which references it; this "lifetime" requirement has several implications. If the I/O path and 
conversion string are defined in different COM blocks, an error will be reported. If the I/O path 
is to be used as a formal parameter in a subprogram, the conversion string variable must either 
appear in the same formal parameter list or be defined in a COM block accessible to that 
subprogram. If the I/O path name is passed to subprogram(s) by including it as a pass para- 
meter, the string variable must currently be defined in the context which defined the I/O path. 

When CONVERT OUT is in effect, the specified conversions are made after any end-of-line 
(EOL) sequence has been inserted into the data, but before parity generation is performed 
(with the PARITY attribute). When CONVERT IN is in effect, conversions are made after parity 
is checked (if enabled), but before the data are checked for any item- or statement-termination 
characters. 

Keep in mind that no non-default CONVERT attribute can be assigned to an I/O path that 
currently possesses the FORMAT OFF attribute, and vice versa. 

Changing the EOL Sequence 

An end-of-line (EOL) sequence is normally sent following the last item sent with free-field 
OUTPUT statements and when the "L" specifier is used in an OUTPUT that uses an image. 
The default EOL characters are carriage-return and line-feed (CR/LF), sent with no device- 
dependent END indication. It is also possible to define your own special EOL sequences that 
include sending special characters, sending an END indication, and delaying a specified amount 
of time after sending the last EOL character. 

In order to define non-default EOL sequences to be sent by the OUTPUT statement, an I/O 
path must be used. The EOL sequence is specified in one of the ASSIGN statements which 
describe the I/O path. An example is as follows. 

ASSIGN eOeuice TO IZiEOL '"-fL-fCr" 

The characters in quotes are the EOL characters. Any character in the range CHR$(0) through 
CHR$(255) may be included in the string expression that defines the EOL characters; however, 
the length of the sequence is limited to eight characters or less. The characters are put into the 
output data before any conversion is performed (if CONVERT OUT is in effect). 

If END is included in the EOL attribute, an interface-dependent "END" indication is sent with 
(or after) the last character of the EOL sequence. However, if no EOL sequence is sent, the 
END indication is also suppressed. The following statement shows an example of defining the 
EOL sequence to include an END indication. 

ASSIGN iDeuice TO 20;E0L CHR$ ( 1 3 ) &:CHR$ (1 ) END 
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With the HP-IB Interface, the END indication is an End-or-Identify message (EOI) sent with the 
last EOL character. The individual chapter that describes programming each interface further 
describes each interface's END indication (if implemented). 

If DELAY is included, the system delays the specified number of seconds (after sending the last 
EOL character and/or END indication) before executing any subsequent BASIC statement. 

ASSIGN @Device;EOL "CrI-f" DELAY 0*1 

This parameter is useful when using slower devices which the computer can "overrun" if data 
are sent as rapidly as the computer can send them. For example, a printer connected to the 
computer through a serial interface set to operate at 300 baud might require a delay after 
receiving a CR character to allow the carriage to return before sending further characters. Note 
that the DELAY parameter is not exact; it specifies the minimum amount of delay. 

The default EOL sequence is a CR and LF sent with no end indication and no delay; this default 
can be restored by using the EOL OFF attribute. 

Parity Generation and Checking 

Parity is an indication used to help determine whether or not a quantity of data has been 
communicated without error. The sending device generates the parity indication, which is then 
checked against the parity expected by the receiving device. If the two indications don't agree, a 
parity error is reported. 

With this system, parity may be indicated by the most significant bit of a data byte. The parity bit 
is generated (during OUTPUT) or checked (during ENTER) by the system according to the 
current PARITY attribute in effect for the I/O path through which the data bytes are being sent 
or received. 

Unless otherwise specified, the system will not generate or check parity (the default mode is 
PARITY OFF). The following optional PARITY attributes are available: 



Option 



OFF 
EVEN 
ODD 
ONE 
ZERO 



Effect During ENTER 



No check is performed 
Check for even parity 
Check for odd parity 
Check for parity bit set (1) 
Check for parity bit clear (0) 



Effect During OUTPUT 



No parity is generated 
Generate even parity 
Generate odd parity 
Set parity bit (1) 
Clear parity bit (0) 



If PARITY EVEN is specified, the parity bit will be a 1 when required to make the total number 
of I's in the byte an even number; for instance, a byte with a value of 1 will have the parity bit 
set to 1 with even parity. Conversely, PARITY ODD specifies that the parity bit will be a 1 when 
required to make the total number of I's odd. PARITY ONE specifies that the parity bit will 
always be 1, while PARITY ZERO specifies that it will always be 0. PARITY OFF disables parity 
generation and checking, if currently enabled for the I/O path. 
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To enable parity generation during OUTPUT and ENTER operations, assign a PARITY option 
to an I/O path. For example: 

ASSIGN iSerial TO SJPARITY ODD 

specifies that all data sent through the I/O path ©Serial will use the most signficant bit of each 
byte for parity. However, only 128 different characters will be available, since one bit of the 
eight is not available for data representation. 

If the system detects a parity error while executing an ENTER statement, error 152 
(Parity error) will be reported. All characters entered up to (but not including) the 
erroneous byte will be assigned to the appropriate variable, after which the system will report 
the error. 

If the receiving device detects a parity error, it will be responsible for communicating the error to 
the computer. A typical means would be to enable the interface to signal the error by generating 
an interrupt. See the chapters that describe interrupts in general and interrupts for the specific 
interface. 

Parity is generated after conversions have been made during OUTPUT and is checked before 
conversions during ENTER. After parity is checked on inbound data, the parity bit is cleared; 
however, when PARITY OFF is in effect, bit 7 is not affected. 

Disabling parity generation and checking is accomplished by assigning the PARITY OFF attri- 
bute to the I/O path. 

ASSIGN @Se rial ;PARITY OFF 

Parity is also disabled when an I/O path name is explicitly closed and then re-assigned, when an 
I/O path name is re-assigned without being closed, and when the default attributes are restored 
with statements such as ASSIGN SSerial. 

Keep in mind that a non-default PARITY attribute cannot be assigned to an I/O path that 
currently possesses the FORMAT OFF attribute, and vice versa. 
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Determining the Outcome of ASSIGN Statements 

Although F^ETURN is not an attribute, including it in the list of attributes directs the system to 
place a a numeric code that indicates the outcome of the ASSIGN operation into the specified 
numeric variable. The following statement shows an example of enabling this error check: 

ASSIGN @Deyice TO 1 2 ! RETURN Out c owe 

If the operation is successful, a is returned. If a non-zero value is returned, it is the error 
number which otherwise would have been reported. For instance, if an interface was not 
present at select code 12, the system would have placed a value of 163 in Outcowe. This 
value is the error code for I/O interface not present. 

The following statement shows a method of determining the Open/Closed status of the I/O 
path. 

ASSIGN @Deyice jRETURN Closed-Status 

If ©Device is currently Open, then is returned; if it is Closed, then 177 is returned 
(Undefined I/O path name). When RETURN is used in this manner, the default attri- 
butes are not restored. 

When RETURN is used in this manner, ON ERROR is normally disabled during the ASSIGN 
statement; however, there are certain errors which cannot be trapped by using RETURN in the 
ASSIGN statement. 

If more than one error occurred during the ASSIGN, there is no assurance that the error 
number returned is either the first or the last error. 
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Concepts of Unified I/O 

The computer's BASIC language system and hardware provide the ability to communicate with 
the several system resources with the OUTPUT and ENTER statements. Chapters 8 and 9 
described how to communicate with the operator (through the CRT and keyboard) by using 
these I/O statements. The next section of this chapter describes how data can be moved to and 
from string variables with OUTPUT and ENTER statements. Chapter 11 describes how to use 
buffers and TRANSFER, which can also be used to communicate with several system re- 
sources. 

Chapter 12 describes how these I/O statements are used to communicate with HP-IB peripheral 
devices. And, if you have read about mass storage operations (Chapter 7 of BASIC Program- 
ming Techniques), you know that the ENTER and OUTPUT statements are also used to move 
data between the computer and mass storage files. This ability to move data between the 
computer and all of its resources with the same statements is a very powerful capability of the 
computer's BASIC language. 

Before briefly discussing I/O paths to mass storage files, the following discussion will present 
some background information that will help you understand the rationale behind implementing 
the two data representations used by the computer. The remainder of this chapter then presents 
several uses of this language structure. 

Data-Representation Design Criteria 

As you know, the computer supports two general data representations — the ASCII and the 
internal representations. This discussion presents the rationale of their design. 

The data representations used by the computer were chosen according to the following 
criteria. 

• to maximize the rate at which computations can be made 

• to maximize the rate at which the computer can move the data between its resources 

• to minimize the amount of storage space required to store a given amount of data 

• to be compatible with the data representation used by the resources with which the 
computer is to communicate 

The internal representations implemented in the computer are designed according to the first 
three of the above criteria. However, the last criterion must always be met if communication is 
to be achieved. If the resource uses the ASCII representation, this compatibility requirement 
takes precedence over the other design criteria. The ASCII representation fulfills this last 
criterion for most devices and for the computer operator. The first three criteria are further 
discussed in the following description of data representations used for mass storage files. 

I/O Paths to Files 

There are two types of internal-disc data files, known as BDAT and ASCII files. Only the ASCII 
representation is used with ASCII files, but either representation can be used with BDAT files. 
The I/O paths to these files are described in this section to further justify the internal data 
representations implemented in the computer and to preface the applications presented in the 
last section of this chapter. 
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BOAT Files 

BOAT (binary data) files have been designed with the first three of the preceding design criteria 
in mind. Both numeric and string computations are much faster. These internal representa- 
tions allow much more data to be stored on a disc because there is no storage overhead (i.e., 
data items do not require a header that describes the type and length of the item) and numeric 
data can be represented with fewer bits. 

The transfer time required for each data item is also decreased. Numeric output operations are 
always much faster because the data are not re-formatted; all enter operations are also much 
faster because the computer does not have to search for item or statement terminators. 

In addition, I/O paths to BOAT data files can use either the ASCII or the internal data represen- 
tation; however, unless otherwise specified, the I/O path to a BOAT file is automatically 
assigned the default attribute of FORMAT OFF. 

The following program shows a few of the features of BOAT files. The program first outputs an 
internal-form string (with FORMAT ON) and then enters the length header and string characters 
with FORMAT OFF. 

100 OPTION BASE 1 

110 DIM Len3th$Ca] »Data*C25G] »Irit_forfTt$C25B] 

120 ! 

130 ! Create a BOAT file (1 record; 25G by t e s/ reco rd . ) 

lao ON ERROR GOTO A 1 read y _c re at e d 

150 CREATE BDAT "B_file"»l 

ISO Already-created: OFF ERROR 

170 ! 

180 ! Use FORMAT ON durinS output. 

190 ASSIGN @Io_path TO "B_f i 1 e " .FORMAT ON 

200 ! 

210 Leridth$ = CHR$(0)6:CHR$(0) ! Create length header. 

220 LeriSth$ = Lenath$6:CHR$(0)6=CHR*(252) 

230 ! 

240 ! Generate 25G-cha rac te r strinS. 

250 Data*="0123a5B7" 

2G0 FOR Doublin^=i TO 5 

270 Data$ = Data$6:Data$ 

280 NEXT Doubling 

290 ! Use only 1st 252 characters. 

300 Data$=Data$Cl »252] 

310 ! 

320 ! Generate in t e rnal -f o rm and output. 

330 Int_f rfrt* = Len3th$&:Data$ 

340 OUTPUT @Io_path ;int_f orm$; 

350 ASSIGN @Io_path TO * 

360 ! 

370 ! Use FORMAT OFF durinS enter (default). 

300 ASSIGN @Io_path TO "B_file" 

390 ! 
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400 ! Enter and print data and « of characterst 

aiO ENTER Data* 

420 PRINT LEN(Data$) ; "cha racte rs entered." 

430 PRINT 

440 PRINT Data$ 

450 ASSIGN §Io_path TO * ! Close I/O path. 

460 ! ' 

470 END 

ASCII Files 

ASCII files are designed both for compatibility with other HP disc drives and for program files. 
This compatibility requirement imposes the restriction that the data must be in its ASCII repre- 
sentation. Each data item sent to these files is a special case of the FORMAT ON representa- 
tion; each item is preceded by a two-byte length header (analogous to the internal form of 
string data). Also, the FORMAT OFF attribute cannot be assigned to I/O paths to ASCII files, 
and OUTPUT or ENTER statements cannot use images when sending data to or receiving data 
from ASCII files. 

The following program shows the I/O path name "@Io_path" being assigned to the ASCII file 
called "ASC_FILE". Notice that the file name is in all uppercase letters; this is also a compatibil- 
ity requirement if the file is to be used with other disc drives. The program creates a program 
file, then gets and runs the program it has created. If you type in and run the program, be sure 
to save (or store) it before running it, as the program is scratched before running the "new" 
program. 

100 DIN Line$(l:3)C100] 

110 ON ERROR GOTO Al re ad >'_e x i s t s 

120 CREATE ASCII "ASC_FILE".l ! 1 record. 

130 Al ready-exists : OFF ERROR 

140 ! 

150 ASSIGN @Io_path TO "ASC.FILE" 

ISO STATUS @lQ_path »B jPointe r 

170 PRINT "Initially: file pointer= ";Pointer 

180 PRINT 

130 ! 

200 Line$( 1 ) =" 100 PRINT ""New program. 

210 Line$(2)="110 BEEP" 

220 Line$(3)="120 END" 

230 ! 

240 OUTPUT @Io_path ;Lirie$(*) 

250 STATUS @ I o_pa t h tS ? Po i n t e r 

260 PRINT "After OUTPUT: file pointer= ";Pointer 

270 PRINT 

280 ! 

230 GET "ASC_FILE" ! Implicitly closes I/O path. 

3 ! 

310 END 
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Data Representation Summary 

The following table summarizes the control that the program has over which FORMAT attribute 
is assigned to I/O paths. 



Type of 


Default Format 


Can Default Format 


Resource 


Attribute Used 


Attribute Be Changed? 


Devices 


FORMAT ON 


Yes, if an I/O path 
name is used' 


BOAT Files 


FORMAT OFF 


Yes' 


ASCII Files 


FORMAT ON 


No^ 


String Variables 


FORMAT ON 


No 


Buffers 


FORMAT ON 


Yes 



Applications of Unified I/O 

This section describes two uses of the powerful unified-I/0 scheme of the computer. The first 
application contains further details and uses of I/O operations with string variables. The second 
application involves using a disc file to simulate a device. 

I/O Operations with String Variables 

Chapter 3 briefly described how string variables may be specified as the source or destination of 
data in I/O statements, but it described neither the details nor many uses of these operations. 
This section describes both the details of and several uses of outputting data to and entering 
data from string variables. 

Outputting Data to String Variables 

When a string variable is specified as the destination of data in an OUTPUT statement, source 
items are evaluated individually and placed into the variable according to the free-field rules or 
the specified image, depending on which type of OUTPUT statement is used. Thus, item 
terminators may or may not be placed into the variable. The ASCII data representation is 
always used during outputs to string variables; in fact, data output to string variables is 
exactly like that sent to devices through I/O paths with the FORMAT ON attribute. 

Characters are always placed into the variable beginning at the first position; no other position 
can be specified as the beginning position at which data will be placed. Thus, random access of 
the infornriation in string variables is not allowed from OUTPUT and ENTER statements; all 
data must be accessed serially. For instance, if the characters "1234" are output to a string 
variable by one OUTPUT statement, and a subsequent OUTPUT statement outputs the charac- 
ters "5678" to the same variable, the second output does not begin where the first one left off 
(i.e., at string position five). The second OUTPUT statement begins placing characters in 
position one, just as the first OUTPUT statement did, overwriting the data initially output to the 
variable by the first OUTPUT statement. 



1 FORMAT ON is automatically used as the attribute whenever an image is used by an OUTPUT or ENTER statement, regardless of the 
attribute currently assigned to the I/O path. 

2 The data representation used with ASCII files is a special case of the FORMAT ON representation. 
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The string variable's length header (4 bytes) is updated and compared to the dimensioned 
length of the string as characters are output to the variable. If the string is filled before all items 
have been output, an error is reported; however, the string contains the first n characters output 
(where n is the dimensioned length of the string). 

Example 

The following program outputs string and numeric data items to a string variable and then calls 
a subprogram which displays each character, its decimal code, and its position within the 
variable. 

100 ASSIGN iCrt TO 1 ! CRT is disp. device. 

110 ! 

120 OUTPUT St r_yar$;i2 »"AB" »3a 

130 ! 

lao CALL Read_st ririS(@Crt >St r_uar$) 

150 ! 

IGO END 

170 ! 

180 ! 

190 SUB Read_st rin S ( @Di sp »St r_i.)ar$) 

200 ! 

210 ! Table ii e a d i n S . 

220 OUTPUT iDisp!" " 

230 OUTPUT @Disp ; "Characte r Code Pos." 

240 OUTPUT @Di5p;" " 

250 Dsp_ifTiS$="2X >aA tSX »3D >2X »3D" 

2G0 ! 

270 ! Now read the string's contents. 

280 FOR Str_P05=l TO LEN ( St r_v a r$ ) 

290 Code = NUH(Str_.uar$CStr_PQs;i]) 

300 IF Code<32 THEN ! Don't disp, CTRL chars. 

310 Char$="CTRL" 

320 ELSE 

330 Cha r$ = St r_i.'ar$CSt r_P05 5 1 ] ! Disp. char. 

340 END IF 

350 ! 

3B0 OUTPUT iDisp USING Ds p_ i m 3$ ;Cha r$ »Co d e >St r_PO s 

370 NEXT Str-pos 

380 ! 

390 ! Finish table. 

aOO OUTPUT @Disp5" " 

410 OUTPUT @Disp ! Blank line. 

420 ! 

430 SUBEND 
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Final Display 



Cha ract e r 


Code 


Pos ♦ 




32 


1 


1 . 


as 


2 


2 


50 


3 


t 


aa 


a 


A 


B5 


5 


B 


BB 


B 


CTRL 


13 


7 


CTRL 


10 


8 




32 


9 


3 


51 


10 


a 


52 


11 


CTRL 


13 


12 


CTRL 


10 


13 



Outputting data to a string and then examining the string's contents is usually a more conve- 
nient method of examining output data streams than using a mass storage file. The preceding 
subprogram may facilitate the search for control characters, because they are not actually 
displayed, which could otherwise interfere with examining the data stream. 

Example 

The following example program shows how outputs to string variables can be used to reduce 
the overhead required in ASCII data files. The first method of outputting data to the file requires 
as much media space for overhead as for data storage, due to the two-byte length header that 
precedes each item sent to an ASCII file. The second method uses more computer memory, but 
uses only about half of the storage-media space required by the first method. The second 
method is also the only way to format data sent to ASCII data files. 

100 PRINTER IS 1 

110 ! 

120 ! Create a file 1 record lon^ (=25B bytes)* 

130 ON ERROR GOTO File_exists 

140 CREATE ASCII "TABLE" »1 

150 File-exists: OFF ERROR 

IGO ! 

170 ! 

180 ! First method outputs G4 items ind i u i dual 1 y . « 

190 ASSIGN iAscii TO "TABLE" 
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200 FOR Item=l TO GU ! Store B^ Z-b/te items. 

210 OUTPUT @Ascii ;CHR$( Itefii + 31 )6:CHR*(G4 + RND*32) 

220 STATUS @As c i i »5 ; Re c *By t e 

230 DISP USING I ma iJe_ 1 ; 1 1 em f Re c »By t e 

240 NEXT Item 

250 Ima^e_l: IMAGE "Item "»DD»" Record "»D»" Bvte ".3D 

2G0 DISP 

270 By tes_i.i5ed = 25G*(Rec-l )+Byte-l 

280 PRINT Bytes_used;" bytes used with 1st method." 

230 PRINT 

300 PRINT 

310 ! 

320 ! 

330 ! Second method consolidates items. 

3a0 DIM Array$(l :G4) [23 »St riri3$C128] 

350 ASSIGN iAscii TO "TABLE" 

3G0 ! 

370 FOR Item=l TO 64 

300 Array$( Item)=CHR$( Item + 31 ) &:CHR* ( Ga + RND*32 ) 

390 NEXT Item 

400 ! 

410 OUTPUT St ririsr$ ;Ar ray$(*) 5 ! Consolidate. 

420 OUTPUT @Ascii ;St rin3$ ! OUTPUT as 1 item. 

430 ! 

440 STATUS @Asc i i .5 ;Rec »By t e 

450 By tes_used=256*(Rec-l )+Byte-l 

4B0 PRINT Bytes_used;" bytes used with 2rid method." 

470 ! 

480 END 

The program shows many of the features of using ASCII files and string variables. The first 
method of outputting the data items shows how the file pointer varies as data are sent to the file. 
Note that the file pointer points to the next file position at which a subsequent byte will be 
placed. In this case, it is incremented by four by every OUTPUT statement (since each item is a 
two-byte quantity preceded by a two-byte length header). 

The program could have used a BOAT file, which would have resulted in using slightly less 
disc-media space; however, using BDAT files usually saves much more disc space than would 
be saved in this example. The program does not show that ASCII files cannot be accessed 
randomly; this is one of the major differences between using ASCII and BDAT files. 
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Example 

Outputs to string variables can also be used to generate the string representation of a number, 
rather than using the VAL$ function (or a user-defined function subprogram). The main 
advantage is that you can explicitly specify the number's image while still using only a single 
program line. The following program compares the string generated by the VAL$ function to 
that generated by outputting the number to a string variable. 

100 X=123a5G78 

110 ! 

120 PRINT UAL*(X) 

130 ! 

lao OUTPUT Mal$ USING "«,3D,E";K 

150 PRINT Mal$ 

ISO ! 

170 END 

Printed Results 

1 .23a5G78E+7 
123.E+05 

Entering Data From String Variables 

Data are entered from string variables in much the same manner as output to the variable. All 
ENTER statements that use string variables as the data source interpret the data according to 
the FORMAT ON attribute. Data is read from the variable beginning at the first string position; if 
subsequent ENTER statements read characters from the variable, the read also begins at the 
first position. If more data are to be entered from the string than are contained in the string, an 
error is reported; however, all data entered into the destination variable(s) before the end of the 
string was encountered remain in the variable(s) after the error occurs. 

When entering data from a string variable, the computer keeps track of the number of charac- 
ters taken from the variable and compares it to the string length. Thus, statement -termination 
conditions are not required if all characters are read from the string; the ENTER statement 
automatically terminates when the last character is read from the variable. However, item 
terminators are still required if the items are to be separated and the lengths of the items are not 
known. If the length of each item is known, an image can be used to separate the items. 
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Example 

The following program shows an example of the need for either item terminators or length of 
each item. The first item was not properly terminated and caused the second item to not be 
recognized. 

100 OUTPUT St riri3$;"ABC123" ; ! OUTPUT w/o CR/LF. 

110 ! 

120 ! Now enter the data. 

130 ON ERROR GOTO Try.aSain 

140 ! 

150 First_try: ! 

ISO ENTER St rin3$ ;St r$ >NufTi 

170 OUTPUT i; "First try results:" 

180 OUTPUT i;"Str$= " 5 St r$ » " Nuffl= " 5 Nluh 

190 BEEP ! Report 3ettin3 this far. 

200 STOP 

210 ! 

220 Try_again: OUTPUT 1 ; " E r ro r" ! ERRN i " on Ist try" 

230 OUTPUT 1 ;"STR*=" ;St r$ >"Nu(i)=" ;Nurii 

240 OUTPUT 1 

250 OFF ERROR ! The next one will work. 

2G0 ! 

270 ENTER Strin3$ USING " 3A »3D " ; St r* »Nu(ii 

280 OUTPUT i; "Second try results:" 

230 OUTPUT i;"Str$= " 5 St r$ » "Nurii= " 5 Num 

300 ! 

310 END 

This technique is convenient when attempting to enter an unknown amount of data or when 
numeric and string items within incoming data are not terminated. The data can be entered into 
a string variable and then searched by using images. 

Example 

ENTERS from string variables can also be used to generate a number from ASCII numeric 
characters (a recognizable collection of decimal digits, decimal point, and exponent informa- 
tion), rather than using the VAL function. As with outputs to string variables, images can be 
used to interpret the data being entered. 

30 NufTtber$="Ualue= 43.5879E-13" 

40 ! 

50 ENTER Numbe r$ lvalue 

BO PRINT "OALUE=" ;Ualue 

70 END 
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Taking a Top-Down Approach 

This application shows how the computer's BASIC-language structure may help simplify using 
a "top-down" programming approach. In .this example, a simple algorithm is first designed and 
then expanded into a program in a general-to-specific, stepwise manner. The top-down 
approach shown here begins with the general steps and works toward the specific details of 
each step in an orderly fashion. 

One of the first things you should do when programming computers is to plan the procedure 
before actually coding any software. At this point of the design process, you need to have a 
good understanding of both the problem and the requirements of the program. The general 
tasks that the program is to accomplish must be described before the order of the steps can be 
chosen. The following simple example goes through the steps of taking this top-down approach 
to solving the problem. 

Problem: write a program to monitor the temperature of an experimental oven for one hour. 

Step 1. Verbally describe what the program must do in the most general terms. You may want 
to make a chart or draw a picture to help visualize what is required of the program. 

Initialize the monitoring equipment. Start the timer and turn the oven on. Begin monitoring 
oven temperature and measure it every minute thereafter for one hour. Display the current 
oven temperature, and plot the temperatures vs. time on the CRT. 

Step 2. Verbally describe the algorithm. Again, try to keep the steps as general as possible. 

This process is often termed writing the "pseudo code". Pseudo code is merely a written 
description of the procedure that the computer will execute. The pseudo code can later be 
translated into BASIC-language code. 

Setup the equipment. 

Set the oven temperature and turn it on. 

Initialize the timer. 

Perform the following tasks every minute for one hour. 

Read the oven temperature. 

Display the current temperature and elapsed time. 

Plot the temperature on the CRT. 
Turn the oven and equipment off. 
Signal that the experiment is done. 

Step 3. Begin translating the algorithm into a BASIC-language program. 

The following program follows the general flow of the algorithm. As you become more fluent in 
a computer language, you may be able to write pseudo code that will translate more directly 
into the language. However, avoid the temptation to write the initial algorithm in the computer 
language, because writing the pseudo code is a very important step of this design approach! 
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10 
11 
12 
13 

la 

15 
IB 
17 
18 
19 
20 
21 

7 *? 

23 

2a 

25 
2G 
27 
28 
29 
30 
31 
32 
33 

3a 

35 

36 

37 

38 

39 

UO 

410 

420 

430 

44t: 

450 

4 GO 

470 

480 

490 

500 

510 

520 

530 

540 

550 

SGC 

570 

58(: 



This program: sets up m e a s u r i n 3 e =i u i p m e n t » 
t u r ri 5 an o u e n o n » and initializes a t i m e r • 
The u e n ' s temperature is measured e u e r v 
minute thereafter for one hour. The temp, 
readings are displayed and plotted on the 
CRT. 



R d 3 s _ i n t e r u a 1 = G ! GO seconds between readings. 
Test_l en 3th=G0 ! Run test for GO minutes. 

! 

CALL E=iuip_setup 
CALL Set_temp 
G03UB Gtart-timer 
! 

K e e p _ m n i t r i n S : ! Main 1 o c p . 

! 

GDSUB Timer 
! 

IF S e c n d s < = R d S s _ i n t e r u a 1 THEN 

GOTO K e e p _ m n i t r i n S 
ELSE 

M i n u t e s = M i n u t e 5 + 1 

CALL Read_temp 

CALL Plot_tefflP 
END IF 
I 
I 
IF Minutes<Te5t_lenSth THEN 

GOTO Keep_monitorinS 
ELSE 

CALL Off -equip 

PRINT "End of experiment" 
END IF 
! 

STOP 

! 

! 

! First the subroutines. 
! 

Start-timer: In i t-t ime=TI NEDATE 

PRINT "Timer initialized." 

PRINT 

PRINT 

RETURN 

! 

Timer: ! 

S e c n d s = T I MEDATE - M i n u t e s *G0 - I n i t _ t i m e 
DISP USING Time-ima3e;Minutes»Seconds 

Time-imaSe: IMAGE "Time: ">DD»" min "»DD,D»" sec" 
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590 RETURN 

GOO ! 

GIO END 

B20 ! 

G30 ! 

G40 ! Now the subprograms* 

B50 ! 

BBO SUB E<=iui p_se t UP 

B70 PRINT "Equipment setup." 

BOO SUBEND 

G90 ! 

700 SUB Set_temp 

710 PRINT "Duen temperature set*" 

720 SUBEND 

730 ! 

740 SUB Read-temp 

750 PRINT "Temp.= xx decrees F "5 

7G0 SUBEND 

770 ! 

780 SUB Plot_temp 

730 PRINT "(Plotted)." 

800 PRINT 

810 SUBEND 

820 ! 

830 SUB Off_equip 

SaO PRINT 

850 PRINT "Equipment shut down." 

8G0 PRINT 

870 SUBEND 

At this point, you should run the program to verify that the general program steps are being 
executed in the desired sequence. If not, keep refining the program flow until all steps are 
executed in the proper sequence. This is also a very important step of your design process; the 
sooner you can verify the flow of the main program the better. This approach also relieves you 
of having to set up and perform the actual experiment as the first test of the program. 

Notice also that some of the program steps use CALLs while others use GOSUBs. The general 
convention used in this example is that subprograms are used only when a program step is to be 
expanded later. GOSUBs are used when the routine called will probably not need further 
refinement. As the subprograms are expanded and refined, each can be separately stored and 
loaded from disc files, as shown in the next step. 

Step 4. After the correct order of the steps has been verified, you can begin programming and 
verifying the details of each step (known as stepwise refinement). 

The computer features a mechanism by which the process of expanding each step can be 
simplified. With it, each subprogram can be-<expanded and refined individually and then stored 
separately in a disc file. This facilitates the use of the top-down approach. Each subprogram can 
also be tested separately, if desired. 
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In order to use this mechanism, first save or store the main program; for instance, execute 
BAUE " MA I N 1 ". Then, isolate the subprogram by deleting all other program lines in mem- 
ory. In this case, executing DEL 10 >G50 and DEL 700 t900 would delete the lines which 
are not part of the "Equip_setup" subprogram. The subprogram can then be expanded, tested, 
and stored in a separate disc file. The following display shows that only the "Equip_setup" 
subprogram is currently in memory. 

B60 SUB E^iiip-setup 

B70 PRINT "Equipment setup." 

B80 SUBEND 

B90 ! 

At this point, two steps can be taken. The temperature-measuring device's initialization routine 
can be written, or a test routine which simulates this device by returning a known set of data can 
be written. The most convenient approach at this point is to simulate the device. And with the 
computer's BASIC language, the "Read_temp" subroutine will not have to be re-written later 
when the experiment is performed with the actual device. 

The "Equip-setup" subprogram might be expanded as follows to create a disc file and fill it with 
a known set of temperature readings so that the program can be tested without having to write, 
verify, and refine the routine that will set up the temperature-measuring device. In fact, you 
don't even need the device at this point. 

100 CALL E q u i p _ s e t u p ( @ T e m p _ m e t e r » T e m p ) 

110 END 

120 ! 

130 SUB E q u i p _ 5 e t u p ( @ T e (ti p _ m e t e r t T e m p ) 

140 ! 

150 ! This subroutine will set up a BOAT file to 

1 B ! be used to simulate a t e m p e r a t u r e - m e a s u r i n s 

170 ! device. Refine to set up the actual 

180 ! equipment later. 

190 ! 

200 ON ERROR GOTO Already 

210 CREATE BOAT " Temp_ rd 3s " , 1 

220 ! 

230 ! Output fictitious readings. 

240 ASSIGN @TefiiP_mete r TO "Temp_rd3s" 

250 FOR Read in 3=1 TO BO 

2G0 OUTPUT @Temp_riiete r ;Readin3 + 70 

270 NEXT Reading 

280 ASSIGN @Tefiip_mete r TO * ! Reset pointer. 

290 ! 

300 Already: OFF ERROR 

310 ! 

320 ASSIGN @Temp_meter TO "Temp_rd3s" 

330 ! 

340 PRINT "Equipment setup." 

350 SUBEND 
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Notice that two pass parameters have been added to the formal parameter list. These para- 
meters allow the main program (and subprograms to which these parameters are passed) to 
access this I/O path and variable. The CALL statements in the main program must be changed 
accordingly before the main program is to be run with these subprograms. These parameters 
can also be passed to the subprograms by declaring them in variable common (i.e., by including 
them in the appropriate COM statements). 

After the subprogram has been expanded, tested, and refined, it should be stored in a disc file 
with the STORE command (not the SAVE command). For instance, store the subprogram by 
executing STORE "SETUPl". When the main program is to be tested again, the "Equip_ 
setup" subprogram can be loaded back into memory by executing a 
LOADSUB ALL FROM "SETUPl". 

Since this subprogram names an I/O path which is to be used to simulate the temperature- 
measuring device, the "Read_temp" subprogram can also be expanded at this point. The 
"Read_temp" subprogram only needs to enter a reading from the measuring device (in this 
case, the disc file which has been set up to simulate the temperature-measuring device). The 
following program shows how this subprogram might be expanded. 

740 SUB Read_te(tip ( @Temp_mete r »Temp) 

741 ENTER @Temp_(iie t e r ; Te wp 

750 PRINT "Temp. = " ;Temp ; " decrees F "5 
760 SUBEND 

This subprogram can also be stored in a disc file by executing a statement such as 
STORE "READ-Tl". Now that both of the expanded subprograms have been stored, the 
main program can be retrieved and modified as necessary. Perform a GET "MAINl " (or 
LOAD "MAINl "), and add the pass parameters to the appropriate CALL statements (lines 
200 and 320). Since the main program still contains the initial versions of the expanded 
subprograms, these two subprograms should be deleted. Executing DELSUB Equip_setup 
and DELSUB Read_temp will delete only these subprograms and leave the rest of the 
program intact. 

Now that the main program has been modified to CALL the expanded subroutines, you may 
want to save (or store) a copy of it on the disc. This will relieve you of deleting the old 
subprograms from the program every time it is retrieved. Execute a SAME "MAIN2" (or 
STORE "MAINZ"). Now load the subprograms into memory by executing 
LOADSUB ALL FROM "SETUP 1 " and LOADSUB ALL FROM "READ_T1". 

Running the program first "sets up" the device simulation and then accesses the file as it would 
the actual temperature-measuring device. As you can see, this approach can be used very easily 
on the computer. In addition, the "Read_temp" subprogram need not be revised to access the 
real device. Only "Equip_setup" needs to be revised to assign the I/O path name "@Temp_ 
meter" to the real device. This unified-I/0 scheme makes the computer very powerful and 
reduces "throw-away" code when using this top-down approach. 
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The remainder of the solution of this problem is to fill in the details of each remaining step of the 
process. Each major step of the program can be expanded tested, and refined separately. The 
use of hypothetical data is also a very good technique to isolate program errors before perform- 
ing the experiment. 
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Chapter 

11 



Introduction 

While many applications will not need the specialized techniques presented here, these techni- 
ques aid in communicating with very slow and very fast devices. The TRANS BIN file must be 
present in memory. 

When using OUTPUT and ENTER to communicate with peripheral devices, special problems 
can arise. Normally, program execution does not leave the statement until all data items are 
satisfied; therefore, a very slow device will keep the computer waiting between each byte or 
word. A great amount of time may be wasted while the computer waits for the device to be 
ready for the next item. 

Another problem exists when communicating with a very fast device. The device may attempt 
to send data faster than the computer can accept it. To overcome both problems, an alternate 
method of communication has been implemented — the TRANSFER statement. 

The TRANSFER statement allows you to exchange information with a device or file through I/O 
paths. The most important difference between using TRANSFER and the regular methods of 
communication (OUTPUT and ENTER) is that a transfer can take place concurrently with 
continued program execution. Thus a transfer can be thought of as a "background" process or 
an "overlapped" operation. This has far-reaching consequences that affect the behavior of the 
computer. 

Before any transfer takes place, an area of memory is reserved to hold the data being transfer- 
red. This area of memory is called a buffer. Defining a buffer is somewhat analogous to creating 
a high-speed device inside the computer. Two advantages are gained by simulating a device in 
memory: the buffer is fast enough to accept incoming data from almost any device and the 
actual transfer operation can be handled concurrently with continued program execution. 

Every transfer will use a buffer as either its source or its destination. From the buffer's point of 
view, there are two types of transfers. An inbound transfer moves data from a device or file into 
the buffer. An outbound transfer moves data from the buffer to a device or file. 

In addition to the TRANSFER statement, the OUTPUT statement can be used to place data in 
the buffer and the ENTER statement can be used to remove data from the buffer. 
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The actual method of transfer is device dependent and is chosen by the computer. The three 
possible transfer methods are: DMA (direct memory access), FHS (fast handshake), and INT 
(interrupt). 

The ON EOT statement allows you to define a branch to be taken upon the completion of a 
transfer. When the data being transferred has been divided into records, the ON EOR statement 
can be used to define a branch to be taken after each record is transferred. 



Note 

An active TRANSFER will no t be te rminated by stopping or pausing 
a program. You may use (RESET) or A BORT IO to terminate a 
TRANSFER prematurely. The (CLR I/O) (or (Reset) ) key will not termi- 
nate a TRANSFER. 



If a TRANSFER is active while a program is paused, the I/O ('d) indicator is displayed in the 
lower-right corner of the CRT instead of the pause ( - ) indicator. 



Buffers 

A buffer is a section of computer memory reserved to hold the data being transferred. Two 
types of buffers can be created and assigned to I/O path names. A named buffer is a string 
scalar, an INTEGER array, or a REAL array. An unnamed buffer is a section of memory which 
has no associated variable name. Assigning an I/O path name to a buffer creates a control table. 
This control table defines STATUS and CONTROL registers which can monitor and interact 
with the operation of the buffer. 

All I/O path names, including I/O path names assigned to buffers, use register to indicate the 
path type. 

Status Register - = Invalid I/O path name 

1 = I/O path assigned to a device 

2 = I/O path assigned to a data file 

3 = I/O path assigned to a buffer 

Register returns a 3 when the I/O path is associated with a buffer. Register 1 indicates whether 
the buffer is named or unnamed. 

Status Register 1 - Buffer type (1 - named, 2 = unnamed) 
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Using Buffers 

Creating buffers 

Named buffers are buffers which use variables declared in DIM, COM, REAL, or INTEGER 
statements. Note that a buffer cannot be allocated by an ALLOCATE statement. Named buffers 
are declared by placing the keyword BUFFER after the variable name. For instance: 

DIM A$C256] »B*C25B] BUFFER »C$ 

COM BlocK( 1000) .Temp(lOO) BUFFER » INTEGER X(IO.IO) BUFFER»Y.Z 

REAL Fools-buff (1000) > Real.buf f ( 10 ) BUFFER » No_bijiff(10) 

Only the variable name immediately preceding the keyword BUFFER becomes a buffer. In the 
first example statement, B$ is a buffer while A$ and C$ are not buffers. Declaring a variable as a 
buffer does not prevent it from being used in its normal manner, but care must be taken not to 
corrupt the information in the buffer. 

Assigning Buffers 

Once a named buffer has been declared, an I/O path name can be assigned to it by an ASSIGN 
statement. For instance: 

ASSIGN iPath TO BUFFER B$ 
ASSIGN OBuff TO BUFFER X(#) 

ASSIGN @Buffer TO BUFFER Real_buff(*) 

The I/O path name can now be used to access the buffer. The keyword BUFFER must appear in 
both the variable declaration statement and the ASSIGN statement for named buffers. 

Unnamed buffers are created in ASSIGN statements and can only be accessed by their 1/0 path 
names. Using unnamed buffers ensures data integrity since the buffer cannot be accessed by a 
variable name. Closing (ASSIGN @Path TO *)anI/0 path assigned to an unnamed buffer 
releases the memory reserved for the buffer. This is similar to the behavior of allocated vari- 
ables. The following statement shows a typical unnamed buffer assignment. 

ASSIGN @Buff to BUFFER CB553B] 

The value in brackets indicates the number of bytes of memory to be reserved for the buffer. 
This allows a buffer to be larger than the maximum length of 32 767 bytes for a string variable. 
Named buffers using REAL and INTEGER arrays can also be larger than 32 767 bytes. 
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Once a buffer has been assigned an I/O path name, Status register 2 returns the buffer's 
capacity (maximum size, in bytes). 

Status Register 2 - buffer size in bytes 

When I/O path names are assigned to buffers, the buffer must exist as long as the I/O path name 
is valid. Consider the example of a buffer created locally in a context and then assigned an I/O 
path name declared in COM. When execution leaves the local context, the I/O path name 
would still be valid but the buffer would no longer exist. If this happens, an error is reported: 

ERROR G02 Improper BUFFER lifetime. 

This error also occurs if the buffer and the I/O path name being assigned are in different COM 
areas. 

Buffer Pointers 

In order to understand I/O involving buffers, it is essential to understand how a buffer is set up 
and maintained. 

When an ASSIGN statement associates an I/O path name with a buffer, it also creates and 
initializes a buffer control table. Among the entries in the control table are two pointers and a 
counter which are used to monitor and control all data transfer to and from the buffer through 
the I/O path. The buffer fill pointer points to the next byte of the buffer which can accept data. 
The empty pointer points to the next byte of data which can be read from the buffer. When the 
ASSIGN is performed, both of these pointers are set to the first byte of buffer storage, and the 
counter is set to to signify an empty buffer. 

The current values of the pointers can be checked by using the STATUS statement with the 
following registers. 

Status Register 3 Current fill pointer 

Status Register 4 Current number of bytes in buffer 

Status Register 5 Current empty pointer 

As data is written into the buffer (OUTPUT or TRANSFER), the fill pointer is advanced as 
necessary to point to the next available byte of buffer storage, and the counter is incremented 
by the number of bytes added to the buffer. Similarly, when data is read from the buffer 
(ENTER or TRANSFER), the empty pointer is advanced to point to the first unread byte, and 
the counter is decremented by the number of bytes which have been read. 
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(inbound) 

TRANSFER SDeMice TO SBuffer 



i 



fill pointer 



.ata data data data data data data data data d. 



I empty pointer 

(outbound) 

TRANSFER @Buffer to @File 

It is also important to realize that the buffers used with the TRANSFER statennent are circular. 
This means that when the last byte of buffer storage has been accessed, the system will wrap 
around and access the first byte of buffer storage. The only thing which prevents writing more 
data into the buffer is the byte count (Register 4) to become equal to the buffer capacity 
(Register 2). Similarly, once the system has read the data from the last byte of buffer storage, it 
will next read from the first byte, but reading must cease when the byte count reaches zero. 

Both full and empty buffers have the fill pointer and the empty pointer referencing the same 
byte of buffer storage. The system distinguishes between full and empty by examining the byte 
count. If it is zero, the buffer is empty. If it is equal to the buffer's capacity, the buffer is full. 

It is impossible to perform any operation which would cause the byte count to take on a value 
less than zero or greater than the buffer capacity. Attempting to OUTPUT more data into a full 
buffer or ENTER data from an empty buffer produces: 

ERROR 59 End of file or buffer found 

Since fill and empty pointers are updated independently of each other and a TRANSFER can 
execute concurrently with other statements, it is possible for one TRANSFER to be putting data 
into the buffer while another TRANSFER is removing data. 

The amount of data which can be moved by a single transfer operation is not limited by the 
buffer's capacity. When two TRANSFER statements involving the same buffer are of compara- 
ble speed and execute concurrently, the buffer's fill and empty pointers may never reach the 
empty or full state. If the two TRANSFER statements execute at different speeds because of the 
transfer miode which must be used or because of the throughput capacity of the devices 
involved, it is still possible to keep two TRANSFER statements running concurrently by specify- 
ing the CONT parameter on both. CONT directs a transfer not to terminate when the buffer 
becomes full or empty. Instead, the transfer "goes to sleep" until the buffer is again ready for 
the transfer process to continue. 
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Transfers 

Once a buffer has been created and an I/O path name assigned to it, data can be transferred 
into or out of the buffer by a TRANSFER statement. Every TRANSFER will need a buffer as 
either its source or destination. For example: 

TRANSFER SSource TO OBuffer 

or 

TRANSFER @Buffer TO @De s t i n a t i on 

From the buffer's point of view, there are two types of transfers; inbound and outbound. An 
inbound transfer will move data from a device or file into the buffer, updating a fill pointer and 
byte count as it proceeds. An outbound transfer will remove data from the buffer, updating an 
empty pointer and byte count as necessary. For a complete explanation, see the Anatomy of a 
Buffer section at the end of this chapter. 

The OUTPUT and ENTER statements may be used to interact with the data sent through the 
buffer. If the I/O path name of the buffer is used as the source for an ENTER or the destination 
for an OUTPUT, the control table will be updated automatically. Accessing the data in a named 
buffer by using the variable name will not update the buffer pointers. This could easily lead to 
corruption of the data in the buffer. 

I/O path names used with TRANSFER are restricted to external devices, BOAT files, or buffers. 
A transfer cannot involve the CRT, the keyboard, the BCD interface, or the tape backup of the 
CS80 disc drives. One and only one buffer can be specified in a TRANSFER statement. 
Transfers from buffer to buffer or from device to device are not allowed. 

OUTPUT and ENTER statements can format data according to a given IMAGE list and trans- 
form the data according to the attributes specified in the ASSIGN statement. No data formatting 
or transformation occurs, however, when data are transferred by a TRANSFER statement. 
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Using Transfers 



TRANSFER statements are generally used in one of three catagories: sending data to a file or 
device (outbound), receiving data from a file or device (inbound), and data logging (inbound 
and outbound). 



program 
variable 
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buffer 
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device 
or 
file 
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TRANSFER operations are allowed for all supported mass storage devices. 



182 Advanced Transfer Techniques 



Initiating a Transfer 

Several steps are necessary before a transfer can take place. For instance, a named buffer 
would need a declaration and an assignment to an I/O path name. A string variable is used 
here: 

10 DIM Text$C1025] BUFFER 

20 ASSIGN eBuff TO BUFFER Text$ 

Note that the keyword BUFFER must appear in both declaration and ASSIGN statements. For 
an unnamed buffer only an ASSIGN statement would be necessary. For example: 

ASSIGN @Buff TO BUFFERC1025] 

The next step is to assign path names to the devices used in the transfer. For example, the 
following statement will assign an I/O path name to the printer (PRT is a function, which returns 
device selector 701). 

30 ASSIGN @Pririt TO PRT 

The printer can now be used as the destination device. For the purposes of this example, it is 
convenient to use an OUTPUT statement to fill the buffer instead of assigning a device as the 
source. 

50 FOR 1=1 TO 25 

SO OUTPUT @Buffi"How fiiany times do I need to print this?" 

70 NEXT I 

By using the I/O path name with OUTPUT, the buffer is filled and the fill pointer is updated. 
This is not the same as modifying the variable, which does not change the buffer pointers. 

Now that the necessary steps have been taken, the TRANSFER can begin. 

90 TRANSFER @Buff TO iPrint 

Here is the complete listing of the program. 

10 DIM Tex t$[ 1025] BUFFER 

20 ASSIGN BBuff TO BUFFER Tex-.$ 

30 ASSIGN @Prii-it TO PRT ! 'PRT' returns 701 for printer 

ao ! 

50 FOR 1=1 TO 25 

BO OUTPUT @Biaffi"How many times do I need to print this?" 

70 NEXT I 

80 ! 

SO TRANSFER SBuff TO SPrint ! Start the transfer 

1 ! 

110 FOR 1=1 TO aso 

120 PRINT TABXYd MOD 15.0) !"A5 many times as it taKes." 
130 NEXT I 
laO END 
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In the program, lines 10 and 20 create a named buffer. Line 30 assigns a printer that will be 
used as the destination for the transfer. The OUTPUT statement in line 60 fills the buffer with 
data. Line 90 contains the TRANSFER statement that sends the data in the buffer to the printer. 
Running the program shows the overlapped operation of transfers. Buffered data is being 
printed on the printer while the program prints on the CRT. 

A similar technique can be used for inbound transfers. 

10 DIH Text*[25G] BUFFER .A$ (1 00 ) [80] 

20 ASSIGN @Buff TO BUFFER Text* 

30 ASSIGN iDevice TO 12 ! Some deyice at select code 12 

40 ! 

50 TRANSFER ODeuice TO eBuffiCONT ! Start the transfer 

SO ! 

70 FOR 1=1 TO 100 

80 ENTER @Buff!A$(I) ! Enter the items 

90 NEXT I 

100 ABORTIO eOeuice ! Terminate TRANSFER 

110 ! 

120 END 

A named buffer is created in lines 10 and 20. A device is assigned in line 30 that will be used as 
the source for the transfer. The buffer is filled by the TRANSFER in line 50 and the ENTER 
statement in line 80 empties the buffer. 

Choosing Transfer Parameters 

For a standard inbound transfer, data from the device (or file) is placed in the buffer and the 
TRANSFER is deactivated when the buffer is full. For an outbound transfer, all data is removed 
from the buffer and the TRANSFER is deactivated when the buffer is empty. 

To allow a TRANSFER to continue indefinitely, the CONT parameter can be specified. 

TRANSFER SSource TO @5uffer;C0NT 

Several interesting things happen when a continuous TRANSFER is specified. Execution can- 
not leave the current program context unless the buffer and I/O path name are in COM (or 
passed as parameters), and you will not be able to LO AD, G ET, or ED I T a pr ogram. During 
program development, you can terminate a transfer by [ RESET] (or [ Shift ] ( Break ] ) or ABORTIO 
@Non_buff (use the I/O path name assigned to either the device or file). ABORTIO can be used 
in a program or executed from the keyboard. 

A continuous TRANSFER can also be canceled by writing to a CONTROL register (use the I/O 
path name assigned to the buffer). Note that the CONTROL register only cancels the con- 
tinuous mode. The TRANSFER is still active until the buffer is full or empty. 

CONTROL @ B u f f * 8 ! for inbound transfers 

CONTROL @ B u f f » 9 ; for outbound transfers 
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When the CONT parameter is specified for an inbound transfer, the transfer fills the buffer and 
is then suspended while program execution continues. The suspended transfer "sleeps" until 
another operation removes some data from the buffer. The transfer then "wakes up" and 
continues the transfer operation. When the CONT parameter is specified for an outbound 
transfer, the transfer empties the buffer and is then suspended. As soon as more data are 
available, the transfer "wakes up" and continues the transfer operation. This process proceeds 
until the transfer is completed or the CONT mode is canceled. 

By default, transfers take place concurrently with continued program execution. To defer 
program execution until a transfer is complete, use the WAIT parameter. This allows transfers to 
take place serially (non-overlapped). 

TRANSFER iSource TO SBufferiWAIT 

When the WAIT parameter is specified, the program statement following the TRANSFER will 
not be executed until the transfer has completed. By combining both the CONT and WAIT 
parameters, a continuous serial TRANSFER can be defined. However, this is only legal if you 
already have an active TRANSFER for the buffer in the opposite direction. 

TRANSFER SSource TO @Buf f e r i WA I T .CONT 

The COUNT parameter tells a transfer how many bytes are to be transferred. The following 
TRANSFER specifies 32 bytes to be transferred. The transfer will terminate after 32 bytes have 
been transferred (or when the buffer becomes full for non-continuous transfers). 

TRANSFER gSource TO @Buf f e r ! COUNT 32 

The DELIM parameter can be used to terminate an inbound transfer when a specified character 
is received. The following TRANSFER will terminate when the delimiter (comma) is sent or 
when the buffer is full (unless the CONT parameter is specified). The DELIM parameter is not 
allowed on outbound transfers or WORD transfers. If the DELIM string is the null string, the 
DELIM clause is ignored. This allows programmatic disabling of DELIM checking. An error 
results if the DELIM string contains more than one character. 

TRANSFER iSource TO iBuf f e r ! DEL I M "," 

The END parameter can also be used to terminate a TRANSFER. The END parameter is 
discussed in detail following the introduction of the RECORDS parameter. 

TRANSFER iSource TO iBufferJEND 

It is often desirable to divide the data into records. The RECORDS parameter is then used to 
indicate the size of each record. 
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Whenever RECORDS is used, there must be a parameter which signals the end of a record. The 
EOR (End-Of-Record) parameter can use COUNT, DELIM, or END (discussed later) to signify 
the end of a record. For example, the following statement specifies 4 records of 15 bytes per 
record are to be transferred. 

TRANSFER SSource TO SBuf f e r JRECORDS ^.EOR(COUNT 15) 

When multiple termination conditions are specified, the transfer will terminate when any one of 
the conditions occurs. 

TRANSFER @Source TO iBuf f e r iCDUNT 128»DELIM "!",END 
TRANSFER iSource TO @Buf f e r iRECORDS 100 >EOR ( COUNT 15»END) 

As in all transfer operations, unless the CONT parameter is specified, the TRANSFER will also 
terminate when the buffer is full or empty. 

The END parameter specifies an inbound transfer will be terminated by receiving an interface- 
dependent signal (for devices) or by encountering the current end-of-file (for files). Some 
devices on the HP-IB send an EOI concurrently with the last byte of data. Unless the END 
parameter is specified, receiving an EOI will generate an error. For files, encountering the 
end-of-file will generate an error unless the END parameter is specified. 

Using the END parameter with an outbound transfer on the HP-IB will result in the EOI signal 
being sent concurrently with the last byte of the transfer. If EOR(END) is specified, EOI will be 
sent with the last byte of each record. For files, END will cause the end-of-file pointer to be 
updated at the end of the transfer. Using EOR(END) will cause the pointer to be updated at the 
end of each record. 

The foUovying tables show the different system responses to the END and EOR(END) para- 
meters. 



Inbound TRANSFER 
File 



No END 



END 



EOR(END) 



END,EOR(END) 



Terminate prematurely. 
Bit 3 of Register 10 is set. 
Error 59 waiting. 

Terminate normally. 

Bit 3 of Register 10 is set. 

Terminate normally. 

Bit 3 of Register 10 is set. 



Terminate normally. 
Bit 3 of Register 10 is set. 



Device 



Terminate prematurely. 
Bit 3 of Register 10 is set. 
Error 59 waiting. 

Terminate normally. 

Bit 3 of Register 10 is set. 

Finish current record. 
ON EOR triggered. 
Start new record. 

Terminate normally. 

Bit 3 of Register 10 is set. 
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An error is logged when a transfer terminates prematurely. For overlapped transfers, this error 
is "waiting" and will be reported the next time the non-buffer I/O path name is referenced. At 
that time, any ON ERROR or ON TIMEOUT branches will be triggered. (If the WAIT parameter 
is specified, the error is reported immediately.) See "Error Reporting" for further explanation. 

An ON END branch will be triggered only if the END parameter is not specified. 

Outbound TRANSFER 



No END 
END 

EOR(END) 

END,EOR(END) 



File 


Device 


No special action. 


No special action. 


Update EOF pointer after 
TRANSFER is finished. 


Send an EOI with the 
last byte of TRANSFER. 


Update EOF pointer after 
each record. 


Send an EOI with tiie last 
byte of each record 


Update EOF pointer after 
each record and when the 
TRANSFER is finished. 


Send an EOI with the last 
byte of each record and 
with the last byte of the 
TRANSFER. 



For an outbound transfer to a device, no special action is taken if the device does not support 
EOI. The Serial, Datacomm and GPIO interfaces do not support EOI. 

Branching 

Two types of event-initiated branches can be defined for a transfer. The ON EOT statement 
defines and enables a branch to be taken upon completion of a transfer. The ON FOR state- 
ment defines and enables a branch to be taken every time a record is transferred. 

ON EOT @Dei;ice CALL Process 
ON EOR @File GOTO Parse 

No ON EOR branches will be triggered unless the EOR parameter is specified in the TRANS- 
FER statement and an item is transferred which satisfies one of the end-of record conditions 
(COUNT, DELIM. or END). 

To ensure that a branch receives service, the transfer must complete before attempting to leave 
the context in which the branches are defined. If the I/O path names are local to a program 
context, encountering SUBEND, SUBEXIT, or RETURN before the transfer has completed will 
cause the context switch to be deferred until completion of the transfer. If this happens, any ON 
EOR or ON EOT branch will not be serviced. 
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Certain statements wait until a transfer is completed before they are executed. A complete list of 
these statements is provided later in this chapter. These statements can be used to prevent 
overlapped operation or defer a context switch until completion of the transfer. For example, if 
the following I/O path names were used in a TRANSFER, either of the following statements will 
cause program execution to wait until the transfer is finished. 

ASSIGN @Path TO # (can be a device, file, or buffer) 

WAIT FOR EOT @Non_buf f (can be a device or file) 

When a TFiANSFER is used inside a loop, the entire loop may execute before the transfer has 
completed. If this happens, the second execution of the TRANSFER statement will wait until the 
completion of the first. Any event-initiated branch defined for the TRANSFER (ON EOT or ON 
EOR) will be serviced. 

While the WAIT parameter can be specified to ensure completion of a transfer before proceed- 
ing with the next statement (thus ensuring a branch can be serviced), this defeats any advan- 
tage of overlapped operation. 

The WAIT FOR statement can be used to allow overlapped operation up to the point where the 
WAIT FOFi statement is encountered. The WAIT FOR statement ensures the servicing of an 
event-initiated branch defined for the end-of-transfer or end-of-record. 

Terminating a Transfer 

A transfer is usually terminated by satisfying the conditions specified by the transfer parameters. 
There are times, especially during program development, when you may wish to prematurely 
terminate (abort) a transfer. 



A transfer can be aborted by pressing the [ RESET) (or [ Shift ] ( Break ) ) key. Pressing (RESET) will stop 
the program, close all I/O paths, and destroy all buffer pointers. To abort a transfer without 
stopping the program, the ABORTIO statement can be used from the program or the keyboard. 
For example: 



ABORTIO @Nori_buff 



This statement will terminate any active transfer associated with the I/O path. ABORTIO has no 
effect if a transfer is not in progress. Using ABORTIO does not ensure all data in the buffer is 
transferred, but it does leave the buffer pointers and byte count in their correct state. 



Note 
If the destination of a TRANSFER is a mass storage file, aborting a 
TRANSFER with ABORTIO will not cause data already placed in the 
disc buffer to be written to the disc. Up to 255 bytes of data could be 
lost. 
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While most transfers are terminated by fulfilling the conditions specified by the parameters, a 
continuous TRANSFER (using the CONT parameter) requires a bit more effort to terminate. 

To terminate a continuous TRANSFER without leaving data in the buffer, first cancel the 
continuous mode (with CONTROL), then wait for the transfer to complete. Use register 8 for 
inbound transfers and register 9 for outbound transfers. The following two methods are the 
safest ways of terminating a continuous TRANSFER. 

CONTROL @Buf f t8;0 
WAIT FOR EOT iPath 

CONTROL @Buf f tSiO 
ASSIGN UPath TO # 

Remember that the buffer pointers are not reset to the beginning of the buffer when the transfer 
is finished. The RESET statement (RESET (a Buff) can be used to reset the buffer pointers to 
the beginning of the buffer and the byte count to zero. 

Transfers are not terminated by pausing the program. The I/O indicator in the lower-right 
corner of the CRT will indicate when a transfer is in progress. 

While transfers may continue when the computer is in the paused state, all transfers must 
terminate before entering the stopped state. Pressing (ENTER] , after editing or adding a program 
line, will attempt to put the computer in the stopped state. If a transfer is still in progress, the 
computer will "hang" until t he tr ansfer is completed. To abort the transfer without performing a 
hardware reset, press (CLR I/O] (or ( Breakl ) to clear the (ENTER) and then ABORTIO the non -buffer 
I/O path name fo r each active TRANSFER. If a hardware reset can be tolerated, press ( RESET] 
(or ( Shift ] ( Break ] ) to terminate the transfer. 



Advanced Transfer Techniques 189 



Transfer Examples 

Here is a short program which sets up a continuous transfer from a device through the buffer to 
a BOAT file. A program of this type is useful when the data being received must be saved for 
later analysis. 



10 
20 
30 

ao 

50 

BO 

70 

BO 

90 

100 

110 

120 

130 

140 

150 



Data LoiSiriS Example 

Buffer size should be a multiple of disc sector (256) 



ASSIGN dDeMice TO 717 
ASSIGN SBuf TO BUFFER [512] 
ASSIGN SFile TO "LOG_FILE" 



AssiSn source 
Assisn BUFFER 
AssiSri destination 



deyice on HPIB 
file 



TRANSFER 
TRANSFER 



@ D e y i c e 
@Buf TO 



TO iBufiCONT 
@File iCDNT 



Continuous TRANSFER 
Continuous TRANSFER 



Program execution continues ... 

Data loSSinS continues as a "background" tasK 



PAUSE 
END 



TRANSFER continues in paused state 



The following program creates a BDAT file and then sends it to a printer. Notice that the 
OUTPUT statement used to fill the file placed a CR/LF at the end of each record. The TRANS- 
FER statement (line 90) looks for the carriage-return as a record delimiter. 



10 

20 

30 

40 

50 

GO 

70 

80 

90 

100 

110 

120 

130 

140 

150 

ISO 

170 

180 

190 

200 

210 

220 

230 

240 

250 

2G0 

270 

2B0 

290 

300 

310 

320 

330 



ON ERROR CALL Makefile 

ASSIGN OFile TO "BDAT_FILE" 

OFF ERROR 

ASSIGN SBuff TO BUFFER [204B] 

ASSIGN ePrint TO PRT 

I 



! Test for file's existence 

! A s 5 i s n buffer 

! AssiSn destination 

! ASCII character for carriaSe return 



Cr*=CHR$( 13) 

PRINT "Start" 

TRANSFER @File TO @Buf f iRECORDS lOtEND.EDR (DELIM Cr*) 

! 

TRANSFER @Buff TO SPrint 

FOR 1=1 TO 10000 

PRINT "TRANSFERS RUNNING". I 

STATUS @Buf f .11 iStat 

IF NOT BIT(Stat.B) THEN 180 
NEXT I 
! 

OUTPUT UPrint iCHR$( 12) 
PRINT "File is printed" 
END 



! ASCII character for formfeed 



SUB Makefile 
OFF ERROR 

CREATE BDAT " BDAT.FILE" . 10 , 12 
ASSIGN OFile TO "BDAT_F I LE " iFDRMAT ON 
FOR 1=1 TO 10 

DISP "Writing" il 

READ Mord* 

OUTPUT SFileSWord* 
NEXT I 
DISP 

DATA ONE .TWO .THREE .FOUR .FIUE .SIX .SEMEN .EIGHT .NINE .TEN 
SUBEND 
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The next program continually shows the activity of the buffer. Note that a continuous TRANS- 
FER is used (line 90). Data is placed in the buffer a few bytes at a time (line 130) and the status 
is displayed by the SUB called from line 140. After a few hundred bytes are transferred, the 
continuous mode is canceled (line 180), the program waits for the transfer to finish (line 190), 
and the final status is displayed. 



10 

20 

30 

40 

50 

GO 

70 

80 

90 

100 

110 

120 

130 

140 

150 

ISO 

170 

180 

190 

200 

210 

220 

230 

240 

250 

2G0 

270 

280 

290 

300 

310 

320 

330 

340 

350 

3B0 

370 

380 

390 

400 

410 

420 

430 

440 

450 

460 



PRINTE 

PRINT 

COM SB 

INTEGE 

ASSIGN 

ASSIGN 

DISP " 

TRANSF 

DISP 

! 

REPEAT 
DUTP 
CALL 
Time 

UNTIL 

! 

CQNTRD 
NAIT F 
CALL B 
END 



"SHOW_BUFF' 
R IS CRT 
USING "@" 

uf f iSPrint .B$[47] BUFFER 
R Characters 

SBuff TO BUFFER B$ 

@Print TO PRT 
printer is off line" 
ER SBuf f TO SPrint ;CONT 



UT @Bijffi"AB ' 

B u f f _ s t a t ij s 
5=Time5+l 
Times >100 

L @Buf f i9 ;0 
OR EOT @Print 
u f f _ s t a t IJ s 



Clear Screen 
Declare variables 

Ass i Sn I/O path name 
Ass i 3n I/O path name 
T ransf e r han 3s if no 
Continuous transfer 
Clear display line 

Fill buffer with data 



Cancel continuous mode 
Wait for buffer emptv- 
Shoui final status 



to buffer 
to 701 
printer 



SUB Buf 
COM @ 
STATU 
PRINT 
STATU 
IF Rl 
IF Rl 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 
PRINT 

SUBEND 



f _stat 

Buff ,@ 

S @Buf 

TABXY 

S @Buf 

= 1 THE 

= 2 THE 

" Buff 

TABXY 

TABXY 

TABXY 

TABXY 

TABXY 



us 
Prin 

f ;ro 

(1.1 
f .1 i 
N PR 
N PR 
e rC " 
( 1 .3 
(R3 , 
( 1 .4 
( 1 .5 
(R5 , 



t .B$ BUFFER 

)! "Buffer Status: 
Rl ,R2 ,R3 ,R4 .R5 .RG 
INT "Named "i 
INT " Unnamed " ! 
;UAL*(R2) i"]" 
) ;RPT$( " " ,55) 
3 ) ; " u " ! 

)! ;b$; ! 

);RPT$(" ",55) 

5 ) i " ' " ! 



.R7 ,RB ,R9 ,R10 ,R11 ,R12 ,R13 



Show 
Show 



Shoi, 



fill pointer position 
buffer contents 

empty pointer position 



Fill 
Byte 
EmPt 



'Sele 
'Cont 
'Te rm 
'To t a 



pointer; 
s i n use: 
y pointer; 



;R3 
iR4 
iR5 



i n b un d / u t b u n d " 
ct code ; " iRBi "/" ;R7 
inuous? : " iRB i "/ " ;R9 
. status: " ; R 1 i " / " ; R 1 1 
1 bytes: " ! R 1 2 i " / " i R 1 3 
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Data currently in the buffer can be reused or ignored by manipulating the pointers (with CON- 
TROL). When it is neccessary to move data through the buffer without using I/O path names, the 
CONTROL statement can be used to modify the pointers, thus allowing a TRANSFER to take 
place. The next program uses this technique. The array size used in the next program is for the 
Model 236; change the array size in lines 50 and 60 for other Series 200 and 300 display sizes. You 
must load the GRAPH BIN file to create and execute the program. 



10 

20 

30 

40 

50 

GO 

70 

80 

90 

100 

110 

120 

130 

140 

150 

IGO 

170 

180 

190 

200 

210 

220 

230 

240 

250 

260 

270 

280 

290 

300 

310 

320 

330 

340 

350 



GINIT 

GCLEAR 

GRAPH! 

PRINT 

IMTEGE 

Gbytes 

ASSIGN 

ON ERR 

ASSIGN 

ASSIGN 

GOTO P 



CS ON 

CHR*( 12) 

R I ,Graph( 1 : 12480) BUFFER 

=2«12480 

@Buff TO BUFFER Graph(#) 
OR GOTO Record 

@Read TO "PHOTOS" 

@Read TO # 
1 a V b a c K 



Record:OFF ERROR 

CREATE BOAT " PHOTOS" ,5 .Gbyt es 

ASSIGN eWrite TO "PHOTOS" 

FOR 1=1 TO 5 
GRID I»4(I»4 
GSTDRE Graph(*) 
GCLEAR 

DISP "SAVING *" il 
CONTROL SBuf f ,4iGbytes 
TRANSFER SBuff TO SWriteiWAIT 

NEXT I 

ASSIGN eWrite TO ♦ 

! 

PlaybacK:OFF ERROR 

ASSIGN SRead TO "PHOTOS" 
FOR 1=1 TO 5 

DISP "LOADING «" ;i 

TRANSFER SRead TO §Buff;WAIT 

GLOAD Graph(») 

CONTROL @BLif f f4i0 
NEXT I 
DISP "DONE" 
EMD 



Uses 4 raph i cs 



Clear the screen 

(1:7500) FOR Mode I 22G . Mo d e 1 21 B 

2 ♦ 7500 FOR Model 22G . Model 216 



Enable ERROR 
Test if file 
Close file 
If file exists 



trap 

exists 

then PlaybacK 



Five "PHOTOS" of Sraphics screen 
to be yritten to the BOAT file 



! Fill buffer with GSTORE 



! Tell TRANSFER "The buffer is full" 



! Tell TRANSFER "The buffer is empty' 



The program creates five "photos" of the graphics raster and writes them to a disc file. The file 
is then read and each picture is loaded back into the graphics raster. 
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Special Considerations 

Transfer with Care 

Whenever possible, a transfer will take place concurrently with continued program execution. 
You must carefully construct a program using transfers. A poorly designed transfer may take 
longer to execute than using OUTPUT and ENTER. 

A TRANSFER which uses a local 1/0 path name must terminate before a SUBEXIT, SUBEND, 
or RETURN (from a function) can return execution to the calling context. The system will detect 
that such a transfer is in progress and will make the SUBEXIT wait for the transfer to terminate. 
If this happens, the system will not process any ON EOT (or ON EOR) branch which had been 
defined for the transfer. To allow servicing of the branch, any statement which cannot execute 
in overlap with the TRANSFER can be inserted in the subprogram before the SUBEXIT. Two of 
the most sensible choices are WAIT FDR EOT iNori-bLiff or ASSIGN @Path to *. 

A TRANSFER which uses only non-local I/O path names can execute in ovedap with a SUBEX- 
IT. One word of caution is necessary; if a local ON EOT (or ON EOR) statement is used in the 
subprogram, its branch will not be serviced if the SUBEXIT is encountered before termination 
of the TRANSFER. To ensure the possibility of servicing the branch, insert a statement that 
cannot execute in overlap with the TRANSFER. This is essentially the same technique discus- 
sed in the preceding paragraph. 

More than one I/O path name can be assigned to a named buffer; however, each path name will 
maintain its own set of pointers. Using multiple path names on the same buffer could lead to 
corruption of the data in the buffer. 

Special care should be taken when using REAL arrays as buffers since a device may send a bit 
pattern that is not a valid real number. Accessing the data as a REAL value may produce an 
error. 

Statements Which Affect Concurrency 

The following statements do not wait for the completion of a TRANSFER statement. 

Buffer in use Device in use 

STATUS @Buf STATUS @Deu 
CONTROL @Buf ON EOR @Deu 
SCRATCH A ON EOT @Deu 

OFF EOR §Deu 

OFF EOT @Deu 
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Statements which wait for completion of inbound transfers. 

OUTPUT @Buf 

TRANSFER @Dei.J TO @Buf 

Statements which wait for completion of outbound transfers. 

ENTER @Buf 

TRANSFER iBuf TO @Oey 

Statements which wait for completion of inbound and outbound transfers. 

Buffer in use Device in use 

ASSIGN @Bijf TO * ASSIGN @Deu TO * 

ASSIGN @Buf TO BUFFER C b y t e s ] 

ASSIGN @Buf TO BUFFER B* 

ASSIGN @Dey ASSIGN iDev 

ASSIGN @Deu; (new attributes) ASSIGN @Dev 5 (new attributes) 

WAIT FOR EOT @Oey 
OUTPUT @Deu 
ENTER @Deu 

TRANSFER @Buf TO @Deu 
TRANSFER @Deu TO @Buf 

END END 

SUBEKIT SUBEXIT 

SUBEND SUBEND 

SCRATCH C SCRATCH C 

SCRATCH SCRATCH 

LOAD "PROG" LOAD "PROG" 

GET "PROG" GET "PROG" 

STOP STOP 

CONTROL @Dey 
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Error Reporting 

If an error is encountered during an overlapped transfer, the error is logged in the non-buffer 
I/O path name and reported the next time the non-buffer I/O path name is referenced. Thus, 
the error line reported will be the most recently executed line containing the I/O path name and 
usually not the line containing the TRANSFER statement. For example: 



10 
20 
30 

ao 

50 Ok: 

BO 

70 

BO 

90 

100 

110 

120 

130 

140 

150 

ISO 

170 

IBO 

190 

2 00 

210 

220 

230 

240 



This program shows delayed error report! nS for TRANSFER 



ON ERROR GOTO OK 
PURGE "t.dat_file" 
OFF ERROR 
I 

CREATE BOAT " bd at _f i 1 e " 1 1 

ASSIGN @Non_buf TO "bdat-file" 

INTEGER B(IOO) BUFFER 

ASSIGN @Bijf TO BUFFER B ( » ) 

PRINT 

I 

WAIT 2 

LIST 150.150 

TRANSFER @NDn_buf TO @BufiCONT 

I 

WAIT 2 

LIST 190.190 

STATUS @Bijf .10iStati.i5_by te 

I 

WAIT 2 

LIST 230.230 

STATUS @Non_buf iStatus-byte 

END 



!ap file if it already eKists 



CREATE an empty file 

ASSIGN I/O path name to the file 

Declare a uariable as a buffer 

AssiSn I/D path name to buffer 



\ Error occurs i ri this line 



! Error not reported with @ B u f 



! Error reported with @Nan_bijf 



Since a continuous TRANSFER was specified, the error that occurs in line 150 is reported in 
line 230 when the non_buffer I/O path name is referenced. For continuous transfers, the error is 
always logged with the non-buffer I/O path name. Referencing the buffer's I/O path name (line 
190) does not cause the error to be reported. After running the program, change the CONT 
parameter in line 150 to WAIT. The program will now report the error in line 150 since the 
WAIT parameter specified a serial TRANSFER. 

At the time the error is reported, any ON END (for files), ON TIMEOUT (for devices), or ON 
ERROR statements will be triggered. However, ON END is not triggered when the END para- 
meter is specified. 

Suspended Transfers 

When a TRANSFER statement is executed, that transfer is said to be "active". The transfer 
proceeds until either a termination condition is reached, or until there is nothing else the 
transfer can do for the time being. An example of the latter is a continuous TRANSFER, which 
does not terminate when the buffer is full and has not yet met any other termination condi- 
tions. 



This TRANSFER will be "suspended" to give some other TRANSFER operation a chance to 
empty the buffer. It will not be reactivated until one of the following occurs: 

1. The other TRANSFER operation reaches a record boundary, fills or empties the buffer, 
terminates, or is suspended. 

2. An OUTPUT or ENTER operation active in the other direction fills or empties the buffer, 
or terminates. 
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3. A CONTROL statement is executed to change the fill or empty pointers, or buffer's byte 
count. 

4. A CONTROL statement is executed to cancel continuous mode. 

A TRANSFER cannot be suspended unless it has CONT as one of its transfer parameters. 

Transfer Performance 

For the best performance when transferring files, the buffer size should be a multiple of 256 
bytes (the size of a disc sector). If the buffer is not a multiple of 256 bytes, the system must do 
sector buffering; this is handled automatically, but reduces the transfer rate. 

While a TRANSFER can be assigned to the internal disc drives in the Model 226 and Model 
236, no noticeable increase in speed (compared to OUTPUT or ENTER) will result. Transfers to 
and from external mass storage (except the 9885) will show an increase in speed especially if a 
DMA card is present. 

Some of the discs are capable of overlapped operation. This means that other processing can 
occur while a non-continuous TRANSFER to or from the disc is taking place. In other words, 
the program can execute other statements before the transfer has completed. Overlapped discs 
include the CS80 discs, the HP9895, the HP9121, the HP9133, the HP9134, the HP9135, the 
HP82901, and the HP82902. 

Discs which are not capable of overlapped operation are called serial discs. When executing a 
non-continuous TRANSFER to or from a serial disc, the program will not leave the TRANSFER 
statement until it completes. Serial discs include the internal discs and the HP9885. 

The following example illustrates the difference between a serial disc and an overlapped disc. 

10 OPTION BASE 1 

20 INTEGER B(128.10) ! A 10-sector buffer 

30 LINPUT "Enter m5U5:".Msus* 

ao CREATE BOAT " b dat " &;M5us* . 1 

50 ASSIGN SFile TO "bdat"&Msus* 

BO ASSIGN iBuffer TO BUFFER C 2560] iFORMAT OFF 

70 OUTPUT eBufferiB(») ! Fill SBuffer's buffer with 10 sectors 

80 ON EOT @FiIe GOTO Serial_eQt ! Branch taKen if TRANSFER is serial 

90 TRANSFER HBuffer TO OFile 

100 ON EOT @File GOTO Oy e r 1 appe d_e o t ! Branch taKen if TRANSFER is overlapped 

110 LOOP 

120 1=1+1 

130 PRINT I ."OyERLAPPED" 

140 END LOOP 

150 Serial-eot: ! 

IBO PRINT "SERIAL" 

170 Overlapped_eot: ! 

180 ASSIGN @File TO * 

ISO PURGE "bdat"&:M5U5$ 

200 END 

If this program is used with a serial disc, the program stays in the TRANSFER statement until the 
transfer is complete. Upon completion of the transfer, the ON EOT branch to SeriaLeot is 
taken. 
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If this program is used with an overlapped disc, the TRANSFER statement begins the transfer, 
but the program executes the next statement before the transfer completes. In this program, the 
next statement changes the ON EOT branch. During the transfer, a count and the word 
"OVERLAPPED" are printed. When the transfer is complete, the ON EOT branch to Overlap- 
ped_eot is taken. 

If the CONT parameter is specified for a TRANSFER with a serial disc, the transfer appears 
overlapped because the program executes any statements which follow the TRANSFER state- 
ment before the transfer terminates. Here is what really happens in this case. The transfer 
proceeds until the buffer is full (for inbound transfers) or empty (for outbound transfers). The 
transfer is then suspended because CONT was specified. The TRANSFER statement is exited 
and the next statement is executed. The transfer will remain suspended until the continuous 
mode is terminated or until the buffer is filled (for inbound transfers) or until the buffer is 
emptied (for outbound transfers). If there is a second TRANSFER active for the buffer, an EOR 
or EOT condition for the second TRANSFER can also wake up the suspended TRANSFER. 

In contrast to serial discs, overlapped discs would allow the statement following the TRANSFER 
to execute before the buffer was full or empty. 

The following program illustrates a transfer to a serial device which appears ovedapped. 

10 OPTION BASE 1 

20 INTEGER B(128il0) ! A lO-sector buffer 

30 LINPUT "Enter Overlapped msu5:"t0uerlappedt 

40 CREATE BOAT " b d at " &:0u e r 1 appe d$ , 1 

50 LINPUT "Enter Serial ms us : " »Se r i a 1* 

GO CREATE BOAT " b d at " &:Se ri a 1$ , 10 

70 ASSIGN eOuerlapped TO " b d at "&0u e r 1 appe d$ 

80 OUTPUT eOve Flapped ;B(*) 

90 RESET eOi.ie rl apped ! Position to besinnins 

100 ASSIGN SBuffer TO BUFFER C512]iF0RMAT OFF 

110 ASSIGN eSerial TO " b d at " &Se r i a 1 * 

120 ON EOT eOuerlapped GOTO Eof 

130 TRANSFER BOuerlapped TO @Buf f e r iEND i CONT 

140 TRANSFER SBuffer TO SSerialiCONT 

150 LOOP 

ISO 1=1+1 

170 PRINT I ."OUERLAPPED" 

180 END LOOP 

190 Eof: ! 

200 CONTROL @Buf f er ,9 50 

210 ASSIGN eOuerlapPBd TO * 

220 PURGE "bdaf'&Dverlapped* 

230 ASSIGN eSerial TO » 

240 PURGE "bdat"&Serial$ 

250 END 

In this example, an overlapped disc is used to fill the buffer while a serial disc empties the buffer. 
Any overlapped device could have been used. After both TRANSFER statements are executed, 
the program prints the count and the word "OVERLAPPED" while reading from one disc and 
writing to the other disc. The inbound transfer is terminated when it encounters the end of the 
file. The outbound transfer is terminated when the CONTROL statement cancels the CONT 
mode. 
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Transfer Method 

All transfers use DMA mode whenever possible. However, any one of the following reasons will 
prevent a DMA transfer. 

• The DMA card is not present 

• Both DMA channels are busy 

• The device involved is not HP-IB or GPIO 

• The DELIM parameter is specified 

If DMA cannot be used with the HP-IB or GPIO interfaces, the FHS mode will be used if the 
WAIT parameter was specified and INT. mode will be used if the WAIT parameter was not 
specified. 

The INT mode will always be used for the Serial and Datacomm interfaces. 

If a very slow device is sending a few bytes at a time, the most efficient method of transfer would 
be to interrupt the processor whenever data is ready. Both DMA and INT modes operate in this 
way. The DMA hardware "steals" a single memory cycle from the processor to transfer each 
byte. The INT mode must completely interrupt the processor and therefore takes more time. 

Either type of interrupt (DMA or INT) can occur at any time and will be handled immediately by 
the system. The interrupt doesn't have to wait for a statement to end before it is serviced. This is 
not the same as event-initiated branches which are serviced only at the end of a statement. 

The INT transfers implemented on the HP-IB and GPIO interfaces use a specialized "burst 
interrupt" mode. When an interrupt occurs, the system's interrupt service routine will transfer 
the byte (or word) then wait approximately 20 jjls for another byte. If the device is fast enough 
to accept or generate another byte each 20 |jls, the net transfer rate will be much faster than if 
the system must exit the service routine and then re-enter the routine for the next byte. 

Transfer Speeds for Devices 

The follov;ing table shows the transfer speeds of various devices. 



Device 




Transfer method 






Burst 
Interrupt 


Fast 
Handshake 


DMA 


Burst 
DMA 


HP-IB (98624) inbound 
(bytes/second) outbound 

GPIO (98622) inbound 
(transfers/second) outbound 

Serial (98626) 

Datacomm (98628) 


55K 
75K 

65K 
75K 

19 200 Baud 

19 200 Baud 


130K 
120K 

115K 
115K 


350K 
290K 

540K 
525K 


930K 
1050K 



198 Advanced Transfer Techniques 



Restrictions 

All data must be buffered. This means every TRANSFER statement will have one I/O path assigned 
to a buffer and one 1/0 path assigned to a device (or file). Additionally, transfers are not permitted 
with the CRT, keyboard, BCD interface card, or to the tape backup on CS80 disc drives. For files, 
only BDAT type files can be used with TFJANSFER. Discs initialized with option 3 (1024-byte 
sectors) cannot be used with TRANSFER. 

A buffer can only have one inbound and one outbound I/O operation (using 1/0 path names) at 
any given time. The I/O operation can use TRANSFER, OUTPUT, or ENTER statements. A 
second I/O operation in the same direction must wait until the completion of the current 
operation. A second I/O operation in the opposite direction does not have to wait. 

The HP-IB and GPIO interfaces support only one I/O operation at any given time. A second 
operation must wait until the completion of the first operation. The Serial and Datacomm 
interfaces allow concurrent inbound and outbound transfer operations if each TRANSFER has 
a unique 1/0 path name assigned to the device. An OUTPUT or ENTER must wait until 
completion of transfers in both directions. Thus, concurrent operation requires using TRANS- 
FER statements and not a mixture of TRANSFER, OUTPUT, and ENTER statements. 

The I/O path name assigned to a device can be used in only one 1/0 opjeration at a time. 
However, the path name can be used with OUTPUT, ENTER, and TRANSFER interchange- 
ably. An OUTPUT or ENTER to the I/O path name will be deferred until completion of any 
active TRANSFER for that path name, All file operations (including CAT, CREATE, OUTPUT, 
and ENTER) will be deferred until completion of any TRANSFER using the same interface 
select code. 

Interactions 

The TRANSFER statement restricts some of the interrupts on various devices. If an ON INTR 
statement and an ENABLE INTR statement have been executed for an interface, not all possi- 
ble ON INTR conditions will be triggered during a transfer. 

For the GPIO interface, the PFLG (data ready) interrupt is not triggered during a transfer that 
uses the interface. The EIR (External Interrupt Request) interrupt is triggered even if there is a 
transfer in progress. 

For the Serial Serial interface, the Transmitter Holding Register Empty and Receiver Buffer Full 
interrupts are not triggered during a transfer that uses the interface. The Receiver Line Status 
and Modem Status Change interrupts are triggered even if there is a transfer in progress. 

For the Datacomm interface, all interrupt conditions are triggered even if a transfer is in prog- 
ress. 

For the HP-IB interface, all interrupt conditions are triggered if they occur during a transfer. 
However, certain interrupt conditions may occur which will cause the transfer operation to be 
prematurely terminated. 
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With the exception of the Handshake Error, the majority of interrupt conditions only occur 
when the HP-IB interface is configured as a non-controller. If any of the following interrupt 
conditions are enabled and the given interrupt occurs during a transfer to or from the interface, 
the user interrupt will be logged and the TRANSFER will be prematurely terminated. 

• Parallel Poll Configuration Change 

• My Talk Address Received 

• My Listen Address Received 

• Talker/Listener Address Change 

• Trigger Received 

• Handshake Error 

• Unrecognized Universal Command 

• Secondary Command While Addressed 

• Clear Received 

• Unrecognized Address Command 

If one of these interrupt conditions occurs and the given interrupt condition has not been 
enabled, the interrupt will be ignored and the TRANSFER will not be terminated. 



Note 

When an abortive interrupt condition is ignored, it is possible for 
data to be corrupted. It is recommended that abortive interrupt con- 
ditions be enabled during a transfer. 

The Active Controller and IFC Received interrupt conditions will always prematurely terminate 
a TRANSFER, even if they have not been enabled. 

When an overlapped TRANSFER is prematurely terminated because of an abortive interrupt 
condition, the following error is logged in the non-buffer I/O path name associated with the 
given TR/^NSFER. The error will then be reported the next time the I/O path name is refer- 
enced. 

ERROR 167 I/O interface status error 

Note that if an ON INTR condition is triggered during a transfer, the ON INTR service routine 
will be executed at the next end-of-line. However, if a TRANSFER is using the interface 
specified in an ENABLE INTR statement, the ENABLE INTR statement will wait for the transfer 
to complete. This means that only one interrupt condition can be triggered during a TRANS- 
FER since the interface's interrupts cannot be re-enabled until completion of the transfer. 
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Changing Buffer Attributes 

You can change the I/O path name's attributes without changing the current buffer pointers. 
Just execute another ASSIGN statement with the new attributes. For example: 

ASSIGN §Path ;PARITY OFF 

You will not be able to change all possible attributes in this manner. The BYTE and WORD 
attributes cannot be changed once assigned. 

By specifying just the I/O path name, the default attributes (except BYTE) can be restored. For 
example: 

ASSIGN @Path 

See the ASSIGN statement in the BASIC Language Reference for a complete list of attributes. 



Note 

It is possible to assign more than one I/O path name to a single 
named buffer. Using two I/O path names on the same buffer could 
lead to the corruption of the data in the buffer. Although each path 
name maintains a separate set of buffer pointers, they are pointing to 
the same buffer. 
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Anatomy of a Buffer 



Every buffer has two pointers associated with it; a fill pointer and an empty pointer. The fill 
pointer points to the next available location in the buffer. The empty pointer points to the next 
data item to be removed from the buffer. For example, the following diagram shows a buffer at 
some point in time. Two transfers are in use. An inbound transfer is filling the buffer and an 
outbound transfer is emptying the buffer. 

(inbound) 

TRANSFER iDeuice TO iBuffer 



i 



I pointer 



....ata data data data data data data data data d. 



\ empty pointer 

(outbound) 

TRANSFER iBuffer to @File 

The buffers used for transfers are circular buffers. In a circular buffer, when a pointer encoun- 
ters the end of the buffer it "wraps around" to the beginning of the buffer. Normally, once a 
buffer is filled (the fill pointer catches up to the empty pointer) or emptied (the empty pointer 
catches up to the fill pointer), the associated TRANSFER is deactivated. Re-executing the 
TRANSFE:R statement will initiate another transfer. By using the CONT parameter, a transfer 
can be specified to remain active after a buffer is full or empty in which case the statement need 
not be re-executed. 

When an I/O path name is assigned to a buffer, a control table is created. As data is transferred 
along the path, the control table is automatically updated. 

When it is necessary to check the condition of the transfer, the STATUS statement can be used 
to examine the contents of the buffer's registers. The CONTROL statement can then be used to 
alter the buffer's pointers. 

All I/O path names, including those assigned to buffers, use register to indicate the I/O path 
type. See the table at the end of this section. 

If you plan to transfer data through a buffer without using the I/O path name, it will be 
necessary to change the values of the pointers. Registers 3, 4, and 5 control the positioning of 
the pointers. If either the fill or empty pointer is changed the appropriate pointer is modified and 
no other action is taken. Assuming no active transfer, if the byte count is changed, the empty 
pointer is set to zero and the fill pointer is set to correspond to the length specified. If a transfer is 
active in both directions, you cannot change the byte count or either pointer. If an inbound 
transfer is active, the empty pointer will be adjusted to set the byte count as specified. Similarly, 
if an outbound transfer is active, the fill pointer will be adjusted to match the byte count 
specified. 
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When the byte count is set along with either the fill or empty pointer, the pointer is moved to the 
position specified and the remaining pointer is adjusted to correspond to the specified length. 

If all three pointers are changed, they must be a consistent set to prevent the following error: 

ERROR 19 I fii p r a p e r Maine or out o f , r a n ^ e . 

If both fill and empty pointers are set to the same value, the length must be either zero (buffer 
empty) or the maximum buffer length (buffer full). 

Attempting to change a pointer used by an active TRANSFER will result in the error: 

ERROR G12 Buffer poiriter(s) in use 

The fill pointer can be changed during an outbound transfer, but not during an inbound 
transfer. Similarly, the empty pointer can be changed during an inbound transfer, but not 
during an outbound transfer. 



Note 

When string variables are used as buffers, the length of the string 
should not be changed. Although this does not affect the operation 
of the buffer, it can prevent access to the contents of the buffer by 
the variable name. 
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Status Register 



Buffer Status and Control Registers 

= Invalid I/O path name 

1 = I/O path assigned to a device 

2 = I/O path assigned to a data file 

3 = I/O path assigned to a buffer 



When the status of register indicates a buffer (3), the status and control registers have the 
following meanings. 



Status Register 1 

Status Register 2 

Status Register 3 
Control Register 3 

Status Register 4 
Control Register 4 

Status Register 5 
Control Register 5 

Status Register 6 

Status Register 7 

Status Register 8 
Control Register 8 

Status Register 9 
Control Register 9 



— Buffer type (1 - named, 2 = unnamed) 

— Buffer size in bytes 

— Current fill pointer 

— Set fill pointer 

— Current number of bytes in buffer 

— Set number of bytes 

— Current empty pointer 

— Set empty pointer 

— Interface select code of inbound TRANSFER 

— Interface select code of outbound TRANSFER 

— If non-zero, inbound TRANSFER is continuous 

— Cancel continuous mode inbound TRANSFER if zero 

— If non-zero, outbound TRANSFER is continuous 

— Cancel continuous mode outbound TRANSFER if zero 



Status Register 10 

Most Significant Bit 


— Termination status for inbour 


id TRANSF 


ER 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 





TRANSFER 
Active 


TRANSFER 
Aborted 


TRANSFER 
Error 


Device 
Termination 


Byte 
Count 


Record 
Count 


Match 
Character 


Value = 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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Status Register 11 — Termination status for outbound TRANSFER 



Mosi bigniiicant 


bit 










Lea 


St Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 





TRANSFER 
Active 


TRANSFER 
Aborted 


TRANSFER 

Error 


Device 
Termination 


Byte 
Count 


Record 
Count 





Value = 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 



Status Register 12 
Status Register 13 



Total number of bytes transferred by last inbound TRANSFER 
Total number of bytes transferred by last outbound TRANSFER 
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The HP-IB Interface 



Chapter 



12 



Introduction 

This chapter describes the techniques necessary for programming the HP-IB interface. Many of the 
elementary concepts have been discussed in previous chapters; this chapter describes the specific 
details of how this interface works and how it is used to communicate with and control systems 
consisting of various HP-IB devices. Load the TRANS and 10 BIN files. 

The HP-IB (Hewlett-Packard Interface Bus), commonly called the "bus", provides compatibil- 
ity between the computer and external devices conforming to the IEEE 488-1978 standard. 
Electrical, mechanical, and timing compatibility requirements are all satisfied by this interface. 



Backplane 
Connector 



X 



Data and 
^Controlj. 



HP-IB 
Interface 



Hardware 

and 

Firmware 






Data 



Handshake 



Control 



^ 



:> 



Logic and Shield 
Grounds 



c> 



> 



(l> 

c 
c 
o 
O 



in 

CM 



Shielded Cable 
to Device(s) 



The HP-IB Interface is both easy to use and allows great flexibility in communicating data and 
control information between the computer and external devices. It is one of the easiest methods 
to connect more than one device to the same interface. 



1 See HP-IB Standard for listing of all 24 lines (cable printouts). HP-IB Installation and Service manual. 
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Initial Installation 

Refer to the HP-IB Installation Note for information about setting the switches and installing an 
external HP-IB interface. Once the interface has been properly installed, you can verify that the 
switch settings are what you intended by running the following program. The defaults of the 
internal HP-IB interface can also be checked with the program. The results are displayed on the 
CRT. 

100 PRINTER IS 1 

110 PRINT CHR$(12) ! Clear screen w/ FF» 

120 ! 

130 AsK: INPUT "Enter HP-IB interface select code"»Isc 

140 IF Isc<7 OR Isc>30 THEN GOTO AsK 

150 ! 

IGO STATUS Isc;Card_id 

170 IF Card-idOl THEN 

180 PRINT "Interface at select code"!l5c; 

190 PRINT "is not an HP-IB" 

200 PRINT 

210 STOP 

220 END IF 

230 ! 

2a0 PRINT "HP-IB interface present" 

250 PRINT " at select code";isc 

2B0 PRINT 

270 ! 

280 STATUS I s c » 1 ! I n t r_d wa 

290 Leyel=3+(BINAND(32+1G .Intr_dma) DIU IB) 

300 PRINT "Hardware interrupt leuel =";Leuel 

310 ! 

320 STATUS I s c t3 ! Ad d r_c t r I r 

330 Address=Add r_ct rl r MOD 32 

3a0 PRINT "Primary address =";Addres5 

350 ! 

3G0 Sys_ct rl=BIT( Add r_ct rl r »7) 

370 IF S>'s_ctrl THEN 

380 PRINT "System Controller" 

390 ELSE 

400 PRINT "Non-system Controller" 

410 END IF 

420 ! 

430 END 

The hardware interrupt level is described in Chapter 7. Hardware interrupt level is set to 3 on 
the internal HP-IB interface, but can range from 3 to 6 on external interfaces. Primary address is 
further described in "HP-IB Device Selectors" in the next section. 
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The term "System Controller" is also further described later in this chapter in "General Struc- 
ture of the HP-IB". The internal HP-IB has a jumper that is set at the factory to make it a system 
controller. This jumper is located below the lowest interface slot at the computer backplane. 
The lowest interface (or memory board) in the backplane must be removed to access this 
jumper. If the jumper in the center of the clear plastic cover is placed on the middle and 
rightmost pins, (as seen from the rear of the computer), the computer is set to be a System 
Controller. If it is on the middle and leftmost pins, the computer is not a System Controller. 
External HP-IB interfaces have a switch that controls this interface state. 

Communicating with Devices 

This section describes programming techniques used to output data to and enter data from 
HP-IB devices. General bus operation is also briefly described in this chapter. Later chapters 
will describe: further details of specific bus commands, handling interrupts, and advanced 
programming techniques. 

HP-IB Device Selectors 

Since the HP-IB allows the interconnection of several devices, each device must have a means 
of being uniquely accessed. Specifying just the interface select code of the HP-IB interface 
through which a device is connected to the computer is not sufficient to uniquely identify a 
specific device on the bus. 

Each device "on the bus" has an primary address by which it can be identified; this address 
must be unique to allow individual access of each device. Each HP-IB device has a set of 
switches theit are used to set its address. Thus, when a particular HP-IB device is to be accessed, 
it must be identified with both its interface select code and its bus address. 

The interface select code is the first part of an HP-IB device selector. The interface select code 
of the internal HP-IB is 7; external interfaces can range from 8 to 31. The second part of an 
HP-IB device selector is the device's primary address, which are in the range of through 30. 
For example, to specify the device: 

on interface select code 7 

with primary address 22 use device selector = 722 

on interface select code 10 

with primary address 2 use device selector = 1002 

Remember that each device's address must be unique. The procedure for setting the address of 
an HP-IB device is given in the installation manual for each device. The HP-IB interface also 
has an address. The default address of the internal HP-IB is 21 or 20, depending on whether or 
not it is a System Controller, respectively. The addresses of external HP-IB interfaces are set by 
configuring the address switches on each interface card. Each HP-IB interface's address can be 
determined by reading STATUS register 3 of the appropriate interface select code, and each 
interface's address can be changed by writing to CONTROL register 3. See "Determining 
Controller Status and Address" and "Changing the Controller's Address" for further details. 
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Moving Data Through the HP-IB 

Data is output from and entered into the computer through the HP-IB with the OUTPUT and 
ENTER statements, respectively; all of the techniques described in Chapters 4 and 5 are 
completely applicable with the HP-IB. The only difference between the OUTPUT and ENTER 
statements for the HP-IB and those for other interfaces is the addressing information within 
HP-IB device selectors. 

Examples 

100 Hpib=7 

110 DeMice_addr=22 

120 D e M i c e _ s e 1 e c 1 r = H p i b ♦ 1 00 + D e u i c e _ a d d r 

130 ! 

lao OUTPUT Deuice-selecto r ;"F1R7T2T3" 

150 ENTER Deu ice_se lecto r ;Readin^ 

320 ASSIGN @Hpib_deuice TO 702 

330 OUTPUT @Hpib_deMice ; "Data message" 

340 ENTER 8Hp i b_d e u i c e j Numb e r 

aaO OUTPUT 822;"F1R7T2T3" 

380 ENTER 724 JRe ad in Ss ( * ) 

All of the IMAGE specifiers described in Chapters 4 and 5 can also be used by OUTPUT and 
ENTER statements that access the HP-IB interface, and the definitions of all specifiers remain 
exactly as stated in those chapters. 

Examples 

100 ASSIGN @Pr inter TO 701 

110 OUTPUT ©Printer USING "BA »3X »2D . D" 5 1 tem$ f Quan t i t •/ 

8B0 ASSIGN iDeuice TO 825 

870 OUTPUT @Deuice USING " « >B " 5 B5 »GG .G7 » 13 » 1 

870 ENTER SDeuice USING "«»K";Data$ 

General Structure of the HP-IB 

Communications through the HP-IB are made according to a precisely defined set of rules. 
These rules help to ensure that only orderly communication may take place on the bus. For 
conceptual purposes, the organization of the HP-IB can be compared to that of a committee. A 
committee has certain "rules of order" that govern the manner in which business is to be 
conducted. For the HP-IB, these rules of order are the IEEE 488-1978 standard. 



The HP-IB Interface 209 



One member, designated the "committee chairman," is set apart for the purpose of conducting 
communications between members during the meetings. This chairman is responsible for over- 
seeing the actions of the committee and generally enforces the rules of order to ensure the 
proper conduct of business. If the committee chairman cannot attend a meeting, he designates 
some other member to be "acting chairman." 

On the HP-IB, the System Controller corresponds to the committee chairman. The system 
controller is generally designated by setting a switch on the interface and cannot be changed 
under program control. However, it is possible to designate an "acting chairman" on the 
HP-IB. On the HP-IB, this device is called the Active Controller, and may be any device 
capable of directing HP-IB activities, such as a desktop computer. 

When the System Controller is first turned on or reset, it assumes the role of Active Controller. 
Thus, only one device can be designated System Controller. These responsibilities may be 
subsequently passed to another device while the System Controller tends to other business. 
This ability to pass control allows more than one computer to be connected to the HP-IB at the 
same time. 

In a committee, only one person at a time may speak. It is the chairman's responsibility to 
"recognize" which one member is to speak. Usually, all committee members present always 
listen; however, this is not always the case on the HP-IB. One of the most powerful features of 
the bus is the ability to selectively send data to individual (or groups of) devices. 

Imagine slow note takers and fast note takers on the committee. Suppose that the speaker is 
allowed to talk no faster than the slowest note taker can write. This would guarantee that everybody 
gets the full set of notes and that no one misses any information. However, requiring all presenta- 
tions to go at that slow pace certainly imposes a restriction on our committee, especially if the slow 
note takers do not need the information. Now, if the chairman knows which presentations are not 
important to the slow note takers, he can direct them to put away their notes for those presenta- 
tions. That way, the speaker and the fast note taker(s) can cover more items in less time. 

A similar situation may exist on the HP-IB. Suppose that a printer and a flexible disc are 
connected to the bus. Both devices do not need to listen to all data messages sent through the 
bus. Also, if all the data transfers must be slow enough for the printer to keep up, saving a 
program on the disc would take as long as listing the program on the printer. That would 
certainly not be a very effective use of the speed of the disc drive if it was the only device to 
receive the data. Instead, by "unlistening" the printer whenever it does not need to receive a 
data message, the computer can save a program as fast as the disc can accept it. 

During a committee meeting, the current chairman is responsible for telling the committee 
which member is to be the talker and which is (are) to be the listener(s). Before these assign- 
ments are given, he must get the attention of all members. The talker and listener(s) are then 
designated, and the next data message is presented to the listener(s) by the talker. When the 
talker has finished the message, the designation process may be repeated. 
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On the HP-IB, the Active Controller takes similar action. When talker and listener(s) are to be 
designated, the attention signal line (ATN) is asserted while the talker and listener(s) are being 
addressed. ATN is then cleared, signaling that those devices not addressed to listen may ignore 
all subsequent data messages. Thus, the ATN line separates data from commands; com- 
mands are accompanied by the ATN line being true, while data messages are sent with the ATN 
line false. 

On the HP-IB, devices are addressed to talk and addressed to listen in the following orderly 
manner. The Active Controller first sends a single command which causes all devices to unlis- 
ten. The talker's address is then sent, followed by the address(es) of the listener(s). After all 
listeners have been addressed, the data can be sent from the talker to the listener(s). Only 
device(s) addressed to listen accept any data that is sent through the bus (until the bus is 
reconfigured by subsequent addressing commands). 

The data transfer, or data message, allows for the exchange of information between devices on 
the HP-IB. Our committee conducts business by exchanging ideas and information between 
the speaker and those listening to his presentation. On the HP-IB, data is transferred from the 
active talker to the active listener(s) at a rate determined by the slowest active listener on 
the bus. This restriction on the transfer rate is necessary to ensure that no data is lost by any 
device addressed to listen. The handshake used to transfer each data byte ensures that all data 
output by the talker is received by all active listeners. 

Examples of Bus Sequences 

Most data transfers through the HP-IB involve a talker and only one listener. For instance, 
when an OUTPUT statement is used (by the Active Controller) to send data to an HP-IB device, 
the following sequence of commands and data is sent through the bus. 

OUTPUT 701 ;"Data" 

1. The talker's address is sent (here, the address of the computer; "My Talk Address"), 
which is also a command. 

2. The unlistcn command is sent. 

3. The listener's address (01) is sent, which is also a command. 

4. The data bytes "D", "a", "t", "a", CR, and LF are sent; all bytes are sent using the 
HP-IB's interlocking handshake to ensure that the listener has received each byte. 

Simllariy, most ENTER statements involve transferring data from a talker to only one listener. 
For instance, the following ENTER statement invokes the following sequence of commands and 
data-transfer operations. 

ENTER 722;Uoltatfe 

1. The talker's address (22) is sent, which is a command. 

2. The unlisten command is sent. 

3. The listener's address is sent (here, the computer's address; "My Listen Address"), also a 
command. 

4. The data is sent by device 22 to the computer using the HP-IB handshake. 

Bus sequences, hardware signal lines, and more specific HP-IB operations are discussed in the 
"HP-IB Control Lines" and "Advanced Bus Management" sections. 
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Addressing Multiple Listeners 

HP-IB allows more than one device to listen simultaneously to data sent through the bus (even 
though the data may be accepted at differing rates). The following examples show how the 
Active Controller can address multiple listeners on the bus. 

100 ASSIGN @Listeners TD 701 »702 »703 

110 OUTPUT iListene rs iSt ririS$ 

120 OUTPUT iListeners USING ImaSe-l i A r ray$ ( * ) 

This capability allows a single OUTPUT statement to send data to several devices simultaneous- 
ly. It is however, necessary for all the devices to be on the same interface. When the preceding 
OUTPUT statement is executed, the unlisten command is sent first, followed by the Active 
Controller's talk address and then listen addresses 01, 02, and 03. Data is then sent by the 
controller and accepted by devices at addresses 1, 2, and 3. 

If an ENTER statement that uses the same I/O path name is executed by the Active Controller, 
the first device is addressed as the talker (the source of data) and all the rest of the devices, 
including the Active Controller, are addressed as listeners. The data is then sent from the device 
at address 01 to the devices at addresses 02 and 03 and to the Active Controller. 

130 ENTER iListerie rs 5St ririd$ 

lao ENTER @Listerier5 USING I maSe_2 5 A r ray* ( * ) 

Secondary Addressing 

Many devices have operating modes which are accessed through the extended addressing 
capabilities defined in the bus standard. Extended addressing provides for a second address 
parameter in addition to the primary address. Examples of statements that use extended 
addressing are as follows. 

100 ASSIGN iDeuice TO 72205 ! 22 = p rima rv » 05 = secori da rv . 
110 OUTPUT SDeuice JMessaSe* 

200 OUTPUT 72205;Messa3e$ 

150 ASSIGN SDeuice TO 7220523 ! Additional secondary 
130 ! add ress of 29 * 

170 OUTPUT @Dey ice iMessaSe* 

120 OUTPUT 7220529;Messa3e$ 

The range of secondary addresses is 00-31; up to six secondary addresses may be specified (a 
total of 15 digits including interface select code and primary address). Refer to the device's 
operating manual for programming information associated with the extended addressing capa- 
bility. The HP-IB interface also has a mechanism for detecting secondary commands. For 
further details, see the discussion of interrupts. 
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General Bus Management 



The HP-IB standard provides several mechanisms that allow managing the bus and the devices 
on the bus. Here is a summary of the statements that invoke these control mechanisms. 

ABORT is used to abruptly terminate all bus activity and reset all devices to power-on states. 

CLEAR is used to set all (or only selected) devices to a pre-defined, device-dependent state. 

LOCAL is used to return all (or selected) devices to local (front-panel) control. 

LOCAL LOCKOUT is used to disable all devices' front-panel controls. 

PPOLL is used to perform a parallel poll on all devices (which are configured and capable of 
responding). 

PPOLL CONFIGURE is used to setup the parallel poll response of a particular device. 

PPOLL UNCONFIGURE is used to disable the parallel poll response of a device (or all devices 
on an interface). 

REMOTE is used to put all (or selected) devices into their device-dependent, remote modes. 

SEND is used to manage the bus by sending explicit command or data messages. 

SPOLL is used to perform a serial poll of the specified device (which must be capable of 
responding). 

TRIGGER is used to send the trigger message to a device (or selected group of devices). 

These statements (and functions) are described in the following discussion. However, the 
actions that a device takes upon receiving each of the above commands are, in general, 
different for each device. Refer to a particular device's manuals to determine how it will 
respond. Detailed descriptions of the actual sequence of bus messages invoked by these state- 
ments are contained in "Advanced Bus Management" later in this chapter. 

Remote Control of Devices 

Most HP-IB devices can be controlled either from the front panel or from the bus. If the device's 
front-panel controls are currently functional, it is in the Local state. If it is being controlled 
through the HP-IB, it is in the Remote state. Pressing the front-panel "Local" key will return the 
device to Local (front-panel) control, unless the device is in the Local Lockout state (described 
in a subsequent discussion). 

The Remote message is automatically sent to all devices whenever the System Controller is 
powered on, reset, or sends the Abort message. A device also enters the Remote state auto- 
matically whenever it is addressed. The REMOTE statement also outputs the Remote message, 
which causes all (or specified) devices on the bus to change from local control to remote 
control. The computer must be the System Controller to execute the REMOTE statement. 
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Examples 

REMOTE 7 

ASSIGN SDeuice TO 700 
REMOTE @Deuice 

REMOTE 700 

Locking Out Local Control 

The Local Lockout message effectively locks out the "local" switch present on most HP-IB 
device front panels, preventing a device's user from interfering with system operations by 
pressing buttons and thereby maintaining system integrity. As long as Local Lockout is in effect, 
no bus device can be returned to local control from its front panel. 

The Local Lockout message is sent by executing the LOCAL LOCKOUT statement. This 
message is sent to all device on the specified HP-IB interface, and it can only be sent by the 
computer when it is the Active Controller. 

Examples 

ASSIGN @Hpib TO 7 
LOCAL. LOCKOUT @Hpib 

LOCAL LOCKOUT 7 

The Local Lockout message is cleared when the Local message is sent by executing the LOCAL 
statement. However, executing the ABORT statement does not cancel the Local Lockout 
message. 

Enabling Local Control 

During system operation, it may be necessary for an operator to interact with one or more 
devices. For instance, an operator might need to work from the front panel to make special tests 
or to troubleshoot. And, in general, it is good systems practice to return all devices to local 
control upon conclusion of remote-control operations. Executing the LOCAL statement returns 
the specified devices to local (front-panel) control. The computer must be the Active Controller 
to send the LOCAL message. 

Examples 

ASSIGN @Hpib TO 7 
LOCAL @Hpib 

ASSIGN UDeuice TO 700 
LOCAL @Dei.Jice 
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If primary addressing is specified, the Go-to-Local message is sent only to the specified de- 
vice(s). However, if only the interface select code is specified, the Local message is sent to all 
devices on the specified HP-IB interface and any previous Local Lockout message (which is still 
in effect) is automatically cleared. The computer must be the System Controller to send the 
Local message (by specifying only the interface select code). 

Triggering HP-IB Devices 

The TRIGGER statement sends a Trigger message to a selected device or group of devices. The 
purpose of the Trigger message is to initiate some device-dependent action; for example, it can 
be used to trigger a digital voltmeter to perform its measurement cycle. Because the response of 
a device to a Trigger Message is strictly device-dependent, neither the Trigger message nor the 
interface indicates what action is initiated by the device. 

Examples 

ASSIGN @Hpib ID 7 
TRIGGER @Hpib 

ASSIGN @DeMice TO 707 
TRIGGER iDeuice 

Specifying only the interface select code outputs a Trigger message to all devices currently 
addressed to listen on the bus. Including device addresses in the statement triggers only those 
devices addressed by the statement. The computer can also respond to a trigger from another 
controller on the bus. See "Interrupts While Non-Active Controller" for details. 

Clearing HP-IB Devices 

The CLEAR statement provides a means of "initializing" a device to its predefined, device- 
dependent state. When the CLEAR statement is executed, the Clear message is sent either to all 
devices or to the specified device(s), depending on the information contained within the device 
selector. If only the interface select code is specified, all devices on the specified HP-IB interface 
are cleared. If primary-address information is specified, the Clear message is sent only to the 
specified device. Only the Active Controller can send the Clear message. 

Examples 

ASSIGN @Hpib TO 7 
CLEAR @Hpib 

ASSIGN iDeuice TO 700 
CLEAR iDeuice 
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Aborting Bus Activity 

This statement may be used to terminate ail activity on the bus and return all the HP-IB 
interfaces of all devices to a reset (or power-on) condition. Whether this affects other modes of 
the device depends on the device itself. The computer must be either the active or the system 
controller to perform this function. If the System Controller (which is not the current Active 
Controller) executes this statement, it regains active control of the bus. Only the interface 
select code may be specified; device selectors which contain primary-addressing information 
(such as 724) may not be used. 

Examples 

ASSIGN SHpib TO 7 
ABORT @Hpib 

ABORT 7 

HP-IB SJervice Requests 

Most HP-IB devices, such as voltmeters, frequency counters, and spectrum analyzers, are 
capable of generating a "service request" when""they require the Active Controller to take 
action. Service requests are generally made after the device has completed a task (such as 
making a measurement) or when an error condition exists (such as a printer being out of 
paper). The operating and/or programming manuals for each device describe the device's 
capability to request service and conditions under which the device will request service. 

To request service, the device sends a Service Request message (SRQ) to the Active Controller. 
The mechanism by which the Active Controller detects these requests is the SRQ interrupt. 
Interrupts allow an efficient use of system resources, because the system may be executing a 
program until interrupted by an event's occurrence. If enabled, the external event initiates a 
program branch to a routine which "services" the event (executes remedial action). 

Chapter 7 described interrupt events in general. This chapter describes the two types of inter- 
rupts that can occur on an HP-IB Interface: SRQ interrupts from external devices (that can 
occur while the computer is an Active Controller), and interrupts that can occur while the 
computer is a non-Active Controller. The first type of interrupts are described in this section. 
The second type are described in the section called "The Computer as a Non-Active Con- 
troller." 

Setting Up and Enabling SRQ Interrupts 

In order for an HP-IB device to be able to initiate a service routine in the Active Controller, two 
prerequisites must be met: the SRQ interrupt event must have a service routine defined, and 
the SRQ interrupt must be enabled to initiate the branch to the service routine. The following 
program segment shows an example of setting up and enabling an SRQ interrupt. 

1 H p i b = 7 

110 ON INTR Hpib GOSUB Se ry i c e_ r o ut i n e 

120 ! 

130 Mask=2 ! Bit 1 enables SRQ interrupts. 

lao ENABLE INTR HpibiMasK 
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The value of the mask in the ENABLE INTR statement determines which type(s) of interrupts 
are to be enabled. The value of the mask is automatically written into the HP-IB interface's 
interrupt-enable register (CONTROL register 4) when this statement is executed. Bit 1 is set in 
the preceding example, enabling SRQ interrupts to initiate a program branch. Reading STA- 
TUS register 4 at this point would return a value of 2. 

When an SRQ interrupt is generated by any device on the bus, the program branches to the 
service routine when the current line is exited (either when the line's execution is finished or 
when the line is exited by a call to a user-defined function subprogram). The service routine 
must (in general): 

• determine which device is requesting service (parallel poll) 

• determine what action is requested (serial poll) 

• clear the SRQ line (automatic with serial poll) 

• perform the desired action 

• re-enable interrupts 

• return to the former task (if applicable) 

Servicing SRQ Interrupts 

The SRQ is a level-sensitive interrupt; in other words, if an SRQ is present momentarily but 
does not remain long enough to be sensed by the computer, the interrupt will not be generated. 
The level-sensitive nature of the SRQ line also has further implications, which are described in 
the following paragraphs. 

Example 

Assume that only one device is currently on the bus. The following service routine first serially 
polls the device requesting service, thereby clearing the interrupt request. In this case, the 
computer did not have to determine which device was requesting service because only one 
device is on the bus. It is also assumed that only service request interrupts have been enabled; 
therefore, the type of interrupt need not be determined either. The service is then performed, 
and the SRQ event is re-enabled. 

500 S e r u _ r t n : S e r _ p o 1 1 = S P L L ( @ D e m i c e ) 

510 ENTER iDeuice ;Oalue 

520 PRINT Ualue 

530 ENABLE INTR 7 ! Use preuious mask. 

SaO RETURN 

The standard has defined that when an interrupting device is serially polled, it is to stop 
interrupting until a new condition arises (or the same condition arises again). In order to "clear" 
the SRQ line, it is necessary to perform a serial poll on the device. The poll is an acknowledge- 
ment from the controller to the device that it has seen the request for service and is responding. 
The device then removes its request for service (by releasing SRQ). 
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Had the SFwQ line not been released, the computer would have branched to the service routine 
immediately upon re-enabling interrupts on this interface. This is another implication of the 
level-sensitive nature of the SRQ interrupt. 

It is also iniportant to note that once an interrupt is sensed and logged, the interface cannot 
generate another interrupt until the initial interrupt is serviced. The computer disables all 
subsequent interrupts from an interface until a pending interrupt is serviced. For this reason, it 
was necessary to re-enable the interrupt to allow .for subsequent branching. 

Polling HP-IB Devices 

The Parallel Poll is the fastest means of gathering device status when several devices are 
connected to the bus. Each device (with this capability) can be programmed to respond with 
one bit of status when Parallel Polled, making it possible to obtain the status of several devices 
in one operation. If a device responds affirmatively ("I need service") to a Parallel Poll, more 
information as to its specific status can be obtained by conducting a Serial Poll of the device. 

Configuring Parallel Poll Responses 

Certain devices can be remotely programmed by the Active Controller to respond to a Parallel 
Poll. A device which is currently configured for a Parallel Poll responds to the poll by placing its 
current status on one of the bus data lines. The logic sense of the response and the data-bit 
number can be programmed by the PPOLL CONFIGURE statement. No multiple listeners can 
be specified in the statement; if more than one device is to respond on a single bit, each device 
must be configured with a separate PPOLL CONFIGURE statement. 

Example 

ASSIGN iDeuice TO 701 

PPOLL CONFIGURE @De v i c e 5 Con f i Su re_c o d e 

The value of C o n f i 3 u r e _ c o d e (any numeric expression can be specified) is first rounded 
and then used to configure the device's Parallel Poll Response. The least significant 3 bits (bits 
through 2) of the expression are used to determine which data line the device is to respond on 
(place its status on). Bit 3 specifies the logic sense of the Parallel Poll Response bit of the device. 
For instance, a value of implies that the device's response is when its Status Bit message is 
"I need service." 

Example 

The following statement configures device at address 01 on interface select code 7 to respond 
by placing a on bit 4 (DI05) when its Status Bit response is affirmative. 

PPOLL CONFIGURE 701 54 
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Conducting a Parallel Poll 

The PPOLL function returns a single byte containing up to 8 status bit messages of all devices 
on the bus capable of responding to the poll. Each bit returned by the function corresponds to 
the status bit of the device(s) configured to respond to the parallel poll. (Recall that one or more 
devices can respond on a single line.) The PPOLL function can only be executed when the 
computer is the Active Controller. 

Example 

Respon5e=PP0LL(7) 

Disabling Parallel Poll Responses 

The PPOLL UNCONFIGURE statement gives the computer (as Active Controller) the capabil- 
ity of disabling the Parallel Poll responses of one or more devices on the bus. 

Examples 

The following statement disables device 5 only. 

PPOLL UNCONFIGURE 705 
This statement disables all devices on interface select code 8 from responding to a Parallel Poll. 

PPOLL UNCONFIGURE 8 

If no primary addressing is specified, all bus devices are disabled from responding to a Parallel 
Poll. If primary addressing is specified, only the specified devices (which have the Parallel Poll 
Configure capability) are disabled. 

Conducting a Serial Poll 

A sequential poll of individual devices on the bus is known as a Serial Poll. One entire byte of 
status is returned by the specified device in response to a Serial Poll. This byte is called the 
Status Byte message and, depending on the device, may indicate an overload, a request for 
service, or a printer being out of paper. The particular response of each device depends on the 
device. 

The SPOLL function performs a Serial Poll of the specified device; the computer must be the 
Active Controller. 

Examples 

ASSIGN SDeuice TO 700 

S t a t Li 5 _ b y t e = SPOLL ( @D e u i c e ) 

Spoll_2.a = SP0LL(724) 

Just as the Parallel Poll is not defined for individual devices, the Serial Poll is meaningless for an 
interface; therefore, primary addressing must be used with the SPOLL function. 
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Advanced Bus Management 



Bus communication involves both sending data to devices and sending commands to devices 
and the interface itself. "General Structure of the HP-IB" stated that this communication must 
be made in an orderly fashion and presented a brief sketch of the differences between data and 
commands. However, most of the bus" operations described so far in this chapter involve 
sequences of commands and/or data which are sent automatically by the computer when 
HP-IB statements are executed. This section describes both the commands and data sent by 
HP-IB statements and how to construct your own, custom bus sequences. 

The Message Concept 

The main purpose of the bus is to send information between two (or more) devices. These 
quantities of information sent from talker to listener(s) can be thought of as messages. Howev- 
er, before data can be sent through the bus, it must be properly configured. A sequence of 
commands is generally sent before the data to infprm bus devices which is to send and which is 
(or are) to listen to the subsequent message(s). These commands can also be thought of as 
messages. 

Most bus messages are transmitted by sending a byte (or sequence of bytes) with numeric 
values of through 255 through the bus data lines. When the Attention line (ATN) is true, these 
bytes are considered commands; when ATN is false, they are interpreted as data. Bus com- 
mand groups and their ASCII characters and codes are shown in "Bus Commands and 
Codes". 

Types of Bus Messages 

The messages can be classified into twelve types. This computer is capable of implementing all 
twelve types of interface messages. The following list describes each type of message. 

1. A Data message consists of information which is sent from the talker to the listener(s) 
through the bus data lines. 

2. The Trigger message causes the listening device(s) to initiate device-dependent action(s). 

3. The Clear message causes either the listening device(s) or all of the devices on the bus to 
return to their device-dependent "clear" states. 

4. The Remote message causes listening devices to change to remote program control when 
addressed to listen. 

5. The Local message clears the Remote message from the listening device(s) and returns 
the device(s) to local front-panel control. 

6. The Local Lockout message disables a device's front-panel controls, preventing a de- 
vice's operator from manually interfering with remote program control. 

7. The Clear Lockout/Local message causes all devices on the bus to be removed from 
Local Lockout and to revert to the Local state. This message also clears the Remote 
message from all devices on the bus. 
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8. The Service Request message can be sent by a device at any time to signify that the 
device needs to interact with the the Active Controller. This message is cleared by 
sending the device's Status Byte message, if the device no longer requires service. 

9. A Status Byte message is a byte that represents the status of a single device on the bus. 
This byte is sent in response to a serial poll performed by the Active Controller. Bit 6 
indicates whether the device is sending the Service Request message, and the remaining 
bits indicate other operational conditions of the device. 

10. A Status Bit message is a single bit of device-dependent status. Since more than one 
device can respond on the same line, this Status Bit may be logically combined and/or 
concatenated with Status Bit messages from many devices. Status Bit messages are 
returned in response to a Parallel Poll conducted by the Active Controller. 

1 1 . The Pass Control message transfers the bus management responsibilities from the Active 
Controller to another controller. 

12. The Abort message is sent by the System Controller to assume control of the bus uncon- 
ditionally from the Active Controller. This message terminates all bus communications, 
but is not the same as the Clear message. 

These messages represent the full implementation of all HP-IB system capabilities; all of these 
messages can be sent by this computer. However, each device in a system may be designed to 
use only the messages that are applicable to its purpose in the system. It is important for you to 
be aware of the HP-IB functions implemented on each device in your HP-IB system to ensure 
its operational compatibility with your system. 
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Bus Commands and Codes 

The table below shows the decimal values of IEEE-488 command messages. Remember that 
ATN is true during all of these commands. Notice also that these commands are separated into 
four general categories: Primary Command Groujj, Listen Address Group, Talk Address 
Group, and Secondary Command Group. Subsequent discussions further describe these com- 
mands. 



Decimal 


ASCII 


Interface 




Value 


Character 


Message 


Description 






PCG 


Primary Command Group 


1 


SOH 


GTL 


Go to Local 


4 


EOT 


SDC 


Selected Device Clear 


5 


ENQ 


PPC 


Parallel Poll Configure 


8 


BS 


GET 


Group Execute Trigger 


9 


HT 


TCT 


Take Control 


17 


DCl 


LLO 


Local Lockout 


20 


DC4 


DCL 


Device Clear 


21 


NAK 


PPU 


Parallel Poll Unconfigure 


24 


CAN 


SPE 


Serial Poll Enable 


25 


EM 


SPD 


Serial Poll Disable 






LAG 


Listen Address Group 


32-62 


Space through > 
(Numbers & Special Chars.) 




Listen Addresses through 30 


63 


9 


UNL 


Unlisten 






TAG 


Talk Address Group 


64-94 


@ through t 
(Uppercase ASCII) 




Talk Addresses through 30 


95 


_ (underscore) 


UNT 


Untalk 






SCG 


Secondary Command Group 




~ through ~ 




Secondary Commands through 30 


96-126 


(Lowercase ASCII) 






127 


DEL 




Ignored 
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Address Commands and Codes 

The following table shows the ASCII characters and corresponding codes of the Listen Address 
Group and Talk Address Group commands. The next section describes how to send these 
commands. 



Address Characters 


Address Code 


Address Switch Settings 


Listen 


Talk 


Decimal 


(5) (4) (3) (2) (1) 


Space 


Ca' 








1 


A 


1 


1 


-'' 


B 


2 


10 


# 


C 


3 


11 


$ 


D 


4 


10 


% 


E 


5 


10 1 


& 


F 


6 - - 


110 




G 


7 


111 


( 


H 


8 


10 


) 


I 


9 


10 1 


* 


J 


10 


10 10 


+ 


K 


11 


10 11 




L 


12 


110 


1 


M 


13 


110 1 




N 


14 


1110 


/ 





15 


1111 





P 


16 


10 


1 


Q 


17 


10 1 


2 


R 


18 


10 10 


3 


S 


19 


10 11 


4 


T 


20 


10 10 


5 


U 


21 


10 10 1 


6 


V 


22 


10 110 


7 


W 


23 


10 111 


8 


X 


24 


110 


9 


Y 


25 


110 1 




Z 


26 


110 10 




[ 


27 


110 11 


< 


/ 


28 


1110 


_ 


] 


29 


1110 1 


> 


t 


30 


11110 



The table implicitly shows that: 

• listen address commands can be calculated from the primary address by using one of the 
following equations: 

Listeri_addres5 = 32 + Pri wary -address 

or 



L i s t e n _ a d d r e 5 s $ = CHR$ ( 32 + P r i (ri a r y _ a d d r e 5 s ) 
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• similarly, talk address commands can be calculated from the primary address by using one 
of the following equations 

Talk_address=G4+Pri wary -address 

or 

TalK_add ress$ = CHR$ ( Sa + P r ima ry_add ress ) 

However, the table does not show that: 

• the Unlisten command is "?", CHR$(63) 

• the Untalk command is "_", CHR$(95) 

• therefore, primary address 31 is an unusable device address, since it is used to send the 
Unlisten and Untalk commands. 

Explicit Bus Messages 

It is often desirable (or necessary) to manage the bus by sending explicit sequences of bus 
messages. The SEND statement is the vehicle by which explicit commands and data can be sent 
through the bus. This section shows several uses of this statement. 

Examples of Sending Commands 

As a simple example, suppose the following statement is executed by the Active Controller to 
configure the bus (i.e., to address the talker and listener). 

OUTPUT 701 USING "**K" 

The SEND statement can be used to send the same sequence of commands, as shown in the 
following statement. 

SEND 7;CMD "?U! " 

This statement configures the bus explicitly by sending the following commands: 

• the unlisten command (ASCII character "?"; decimal code 63) 

• talk address 21 (ASCII character "U"; decimal code 85) 

• listen address 1 (ASCII character "!"; decimal code 33) 

The same sequence of commands and data is sent with any of the following statements. 
SEND 7 5 UNL MTA LISTEN 1 
SEND 7 5 UNL TALK 21 LISTEN 1 
SEND 7;CMD 32 + 31 »G4 + 2 1 .32 + 1 
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Commands can be sent by specifying the secondary keyword CMD. The list of commands 
(following CMD) can be any numeric or string expressions. If more than one expression is 
listed, they must be separated by commas. A numeric expression will be evaluated, rounded to 
an integer (MOD 256), and sent as one byte. Each character of a string expression will be sent 
individually. All bytes are sent with ATN true. The computer must be the current Active 
Controller to send commands. 



SEND Isc ;CMD 8 

SEND I5c;TALK New-controller CMD 9 

SEND 8;CMD 1 



Group Execute TriSSer 
Pass Control 
Go to Local 



If SEC is used, the specified secondary commands will be sent. An extended talker may be 
addressed by using SEC after the talk address; extended listener(s) may be addressed by using 
SEC after the listen address(es). 

SEND 7;MTA UNL LISTEN 1 CMD 5 SEC IB ! SENDPPD. 

The computer must be the Active Controller to send CMD, LISTEN, UNL, MLA, TALK, UNT, 
MTA, and SEC. If a non-Active Controller attempts to send any of these messages, an error is 
reported. 

Simulate the following SPOLL function with SEND statements. 

A=SP0LL(72a) 
When an SPOLL is performed, the resulting bus activity is: 

• Unlisten command 

• My Listen Address (the computer's listen address; MLA) 

• device's talk address (one of the TAG commands) 

• Serial Poll Enable command (SPE; decimal code 24) 

• one data byte is read (the Status Byte message) 

• Serial Poll Disable (SPD; decimal code 25) 

• Untalk command 

This is accomplished by either of the following sequences: 



SEND 7;CMD " ?5K " &:CHR$ ( 2^ ) 
ENTER 7 USING "« >B" iA 
SEND 7 5 CMD CHR$ ( 25 )&:"_, " 

SEND 7;UNL MLA TALK 24 CMD 24 
ENTER 7 USING "# .B" ;A 
SEND 7;CMD 25 UNT 



Configure the b u s 5 send SPE. 
Re.ad Status Bvte. 
Send SPD and UntalK, 



The preceding secondary keywords provide the capability of sending various command mes- 
sages through the bus. The activity that results on the bus when several other high-level 
commands are issued is summarized in "HP-IB Message Mnemonics". 
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Examples of Sending Data 

Data messages can be sent by specifying the-secondary keyword DATA. If the computer is the 
Active Controller, the data is sent immediately. However, if the computer is not the Active 
Controller, it waits to be addressed to talk before sending the data. 

SEND 75DATA "Me ss a de " » 13 » 1 ! Send with CR/LF. 

SEND BusiDATA "Data" END ! Send with EOI. 

The data list may contain any mixture of numeric or string expressions; if more than one 
expression is specified, they must be separated by commas. Each numeric expression is evalu- 
ated as an integer (MOD 256) and sent as a single byte. Each string item is evaluated and all 
resultant characters are sent serially. Each byte is sent with ATN false (sent as a data message). 
The last expression may be followed by the secondary keyword END, which causes the EOI 
terminator to be sent concurrently with the last data byte. 

As another example, simulate this ENTER statement with a SEND statement. 

ENTER 72a!Number tStrin3$ 

Any of the following pairs of statements can be used to accomplish the same operation. 

SEND 7;UNL TALK 24 MLA 
ENTER 7 ;Numbe r tSt rin^$ 

SEND 7!UNL TALK Za LISTEN 21 
ENTER 7 SNumbe r *St rinSf 

SEND 7;CMD "?X5" 

ENTER 7;Nu(iiber. StrinS$ 

HP-IB Message Mnemonics 

This section contains the descriptions of several bus messages described by the IEEE 488-1978 
standard. The following table describes message mnemonics, their meanings, and the secon- 
dary keywords used with the SEND statement. The HP-IB messages that require primary 
keywords are noted in the table. 

All BASIC statements which send HP-IB messages (except SEND) always set ATN-true (com- 
mand) messages with the most-significant bit set to zero. Using CMD (with SEND) allows you to 
send ATN-true messages with the most-significant bit set to one. This may be useful for non- 
standard IE:EE-488 devices which require the most-significant bit to have a particular value. 

The CMD and DATA secondary keywords of SEND statements allow string expressions as well 
as numeric expressions (e.g., CMD "?" is the same as CMD 63). All other secondary keywords 
which need data require numeric expressions. Keep this in mind while reading through this 
table. 
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Message 
Mnemonic 


Message 
Description 


SEND Clause Required 
(numeric values are decimal) 


DAB 


Data Byte 


DATA through 255 


DCL 


Device Clear 


CMD 20 (or 148) 


EOI 


End or Identify 


DATA data list END 


GET 


Group Execute Trigg^ 


CMD 8 (or 136) 


GTL 


Go To Local 


CMD 1 (or 129) 


IPC 


Interface Clear 


Not possible with SEND; 
use the ABORT statement. 


LAG 


Listen Address 


LISTEN through 30; 
or CMD 32 through 62; 
or CMD 160 through 190 


LLO 


Local Lockout 


CMD 17 


MLA 


My Listen Address 


MLA 


MTA 


My Talk Address 


MTA 


PPG 


Parallel Poll Configure 


CMD 5 (or 133) 


PPD 


Parallel Poll Disable 


SEC 16; or CMD 112 (or 240) 
(Must be preceded by PF'C.) 


PPE 


Parallel Poll Enable 


SEC + Mask: 

SEC through 15: 

or CMD 96 through 111: 

or CMD 224 through 239 

(Must be preceded by PPC.) 


PPU 


Parallel Poll Unconfigure 


CMD 21 (or 149) 


PPOLL 


Parallel Poll 


Not possible with SEND; 
use the PPOLL function. 


REN 


Remote Enable 


Not possible with SEND; 
use the REMOTE statement. 


SDC 


Selected Device Clear 


CMD 4 (or 132) 


SPD 


Serial Poll Disable 


CMD 25 (or 153) 


SPE 


Serial Poll Enable 


CMD 24 (or 152) 


TAD 


Talk Address 


TALK through 30; 
or CMD 64 through 94; 
or CMD 192 through 222 


TCT 


Take Control 


CMD 9 (or 137) 


UNL 


Unlisten 


UNL: or LISTEN 31; 
or CMD 63 (or 191) 


UNT 


Untalk 


UNT: or TALK 31; 
or CMD 95 (or 223) 
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The Computer As a Non-Active Controller 

The section called "General Structure of the HP-IB" described how comn:iunications take place 
through HP-IB Interfaces. The functions of the S^stim Controller and Active Controller were 
likened to a "committee chairman" and "acting chaiVman," respectively, and the functions of 
each were described. This section describes how the Active Controller may "pass control" to 
another controller and assume the role of a ijon-Actlve Controller. This action is analogous to 
designating another committee member to take the responsibility of acting chairman and then 
becoming a committee member who listens to the acting chairman and speaks when given the 
floor. The following topics will be discussed: 

• Determining whether the computer is currently the Active Controller and/or System Con- 
troller 

• Determining the computer's HP-IB primary address, and changing it, if necessary 

• Passing control to another HP-IB controller 

• Requesting service from the Active Controller 

• Responsibilities of being a non-Active Controller 

• Responding to interrupts that occur while non-Active Controller 

Determining Controller Status and Address 

It is often necessary to determine if an interface is the System Controller and to determine 
whether or not it is the current Active-Controller. It is also often necessary to determine or 
change the interface's primary address. The example program shown in the beginning of this 
chapter interrogated interface STATUS registers and printed the resultant System-Controller 
status and primary address. Those operations are explained in the following paragraphs. 

Example 

Executing the following statement reads STATUS register 3 (of the internal HP-IB) and places 
the current value into the variable Stat_and_addr. Remember that if the statement is executed 
from the keyboard, the variable Stat_and_addr must be defined in the current context. 



STATUS 7 »3 5Stat_and_a 
Status Register 3 

Most Significant Bit 


jdr 




Controller Status and Address 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


BitO 


System 
Controller 


Active 
Controller 





Primary Address of Interface 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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If bit 7 is set (1), it signifies that the interface is the System Controller; if dear (0), it is not the 
System Controller. Only one controller on each HP-IB interface should be configured as the 
System Controller. 

If bit 6 is set (1), it signifies that the interface is currently the Active Controller; if it is clear (0), 
another controller is currently the Active Controller. 

Bits 4 through represent the current value of the interface's primary address, which is in the 
range of through 30. The power-on default value for the internal HP-IB is 21 (if it is the 
System Controller) and 20 (if not the System Controller). For external HP-IB interfaces, the 
default address is set to 21 at the factory but may be changed by setting the address switches on 
the card itself. 

Example 

Calculate the primary address of the interface from the value previously read from STATUS 
register 3. 

Intf -add r^Stat_and_add r MOD 32 

This numerical value corresponds to the talk (or listen) address sent by the computer when an 
OUTPUT (or ENTER) statement containing primary-address information is executed. Talk and 
listen addresses are further described in "Advanced Bus Management". 

Changing the Controller's Address 

It is possible to use the CONTROL statement to change an HP-IB interface's address. 
Example 

CONTROL 7 »3;iritf_addr 

The value of Intf_addr is used to set the address of the HP-IB interface (in this case, the internal 
HP-IB). The valid range of addresses is through 30; address 31 is not used. Thus, if a value 
greater than 30 is specified, the value MOD 32 is used (for example: 32 MOD 32 equals 0, 33 
MOD 32 equals 1, 62 MOD 32 equals 30, and so forth). 

Passing Control 

The current Active Controller can pass this capability to another computer by sending the Take 
Control message (TCT). The Active Controller must first address the prospective new Active 
Controller to talk, after which the TCT message is sent. If the other controller accepts the 
message, it then assumes the role of Active Controller; this computer then assumes the role of a 
non-Active Controller. 
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Passing control can be accomplished in one of two ways: it can be handled by the system, or it 
can be handled by the program. The PASS CONTROL statement can be used. For example, 
the following statements first define the HP-IB Interface's select code and new Active Control- 
ler's primary address and then pass control to that controller. 

100 Hp_ib=7 

110 New_ac_add r=20 

120 PASS CONTROL 100*Hp_i b+New-ac-add r 

The following statements perform the same functions. 

100 Hp_ib=7 

110 New_ac_add r=20 

120 SEND Hp_ib;TALK New_acr_addr CMD 9 

Once the new Active Controller has accepted the TCT command, the controller passing control 
assumes the role of a non-Active Controller (or "HP-IB device") on the specified HP-IB 
Interface. The next section describes the responsibilities of the computer while it is a non-Active 
Controller. 

Interrupts While Non-Active Controller 

When the computer is not an Active Controller, it must be able to detect and respond to many 
types of bus messages and events. 

The computer (as a non-Active Controller) needs to keep track of the following information. 

• It must keep track of itself being addressed as a listener so that it can enter data from the 
current active talker. 

• It must keep track of itself being addressed as a talker so that it can transmit the informa- 
tion desired by the active controller. 

• It must keep track of being sent a Clear, Trigger, Local, or Local Lockout message so that it 
can take appropriate action. 

• It must keep track of control being passed from another controller. 

One way to do this is to continually monitor the HP-IB interface by executing the STATUS 
statement and then taking action when the values returned match the values desired. This is 
obviously a great waste of computer time if the computer could be performing other tasks. 
Instead, the interface hardware can be enabled to monitor bus activity and then generate 
interrupts when certain events take place. 

The computer has the ability to keep track of the occurrences of all of the preceding events. In 
fact, it can monitor up to 16 different interrupt conditions. STATUS registers 4, 5 and 6 provide 
access to the interface state and interrupt information necessary to design very powerful sys- 
tems with a great degree of flexibility. 
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Each individual bit of STATUS register 4 corresponds to the same bit of STATUS register 5. 
Register 4 provides information as to which condition caused an interrupt, while register 5 
keeps track of which interrupt conditions are currently enabled. To enable a combination of 
conditions, add the decimal values for each bit that you want set in the interrupt-enable register. 
This total is then used as the mask parameter in an ENABLE INTR statement. 



Status Register 5 

Most Significant Bit 



Interrupt Enable Mask 



Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bits 


Active 

Controller 


Parallel 

Poll 

Configuration 

Change 


My Talk 
Address 
Received 


My Listen 
Address 
Received 


EOl 
Received 


SPAS 


Remote/ 

Local 
Change 


Talker/ 
Listener 
Address 
Change 


Value = 
- 32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 



Least Significant Bit 



Bit 7 


Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Trigger 
Received 


Handshake 
Error 


Unrecognized 
Universal 
Command 


Secondary 
Command 

While 
Addressed 


Clear 
Received 


Unrecognized 
Addressed 
Command 


SRQ 
Received 


IPC 
Received 


Value = 128 


Value = 64 


Value - 32 


Value = 16 


Value = 8 


Value - 4 


Value = 2 


Value - 1 



Bit 15 enables an interrupt upon becoming the Active Controller. The computer then has the 
ability to manage bus activities. 

Bit 14' enables an interrupt upon detecting a change in Parallel Poll Configuration. 

Bit 13 enables an interrupt upon being addressed as an active talker by the Active Controller. 

Bit 12 enables an interrupt upon being addressed as an active listener by the Active Controller. 

Bit 11 enables an interrupt when an EOI is received during an ENTER operation (the EOI signal 
line is also described in "HP-IB Control Lines"). 

Bit 10 enables an interrupt when the Active Controller performs a Serial Poll on the computer 
(in response to its service request). 

Bit 9 enables an interrupt upon receiving either the Remote or the Local message from the 
active controller, if addressed to listen. The action taken by the computer is, of course, depen- 
dent on the user-programmed service routine. 



1 This condition requires accepting data from tfie bus and ttien explicitly releasing ttie bus. Refer to thie "Advanced Bus Management" section 
for further details. 
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Bit 8 enables an interrupt upon a change in talk or listen address. An interrupt will be generated 
if the computer is addressed to listen or talk or "idled" by an Unlisten or Untalk command. 

Bit 7 enables an interrupt upon receiving a Trigger message, if the computer is currently 
addressed to listen. This interrupt can be used in situations where the computer may be "armed 
and waiting" to initiate action; the active controller sends the Trigger message to the computer 
to cause it to begin its task. 

Bit 6 enables an interrupt if a bus error occurs during an OUTPUT statement. Particulariy, the 
error occurs if none of the devices on the bus respond to the HP-IB's interlocking handshake 
(see "HP-IB Control Lines"). The error typically indicates that either a device is not connected 
or that its power is off. 

Bit 5' enables an interrupt upon receiving an unrecognized Universal Command. This interrupt 
condition provides the computer with the capability of responding to new definitions that may 
be adopted by the IEEE standards committee. 

Bit 4' enables an interrupt upon receiving a Secondary Command (extended addressing) after 
the interface receives either its primary talk address or primary listen address. Again, this 
interrupt provides the computer with a way to detect and respond to special messages from 
another controller. 

Bit 3 enables an interrupt on receiving a Clear message. Reception of either a Device Clear 
message (to all devices) or a Selected Device Clear message (addressed to the computer) will 
cause this type of interrupt. The computer is free to take any "device-dependent" action; such 
as, setting up all default values again, or even restarting the program, if that is defined by the 
programmer to be the "cleared" state of the machine. 

Bit 2' enables an interrupt upon receiving an unrecognized Addressed Command, if the com- 
puter is currently addressed to listen. This interrupt is used to intercept and respond to bus 
commands which are not defined by the standard. 

Bit 1 enables an interrupt upon detecting a Service Request. 

Bit enables an interrupt upon detecting an Interface Clear (IPC). The interrupt is generated 
only when the computer is not the System Controller, as only a System Controller is allowed to 
set the Interface Clear signal line. The service routine typically is used to recover from the 
abrupt termination of an I/O operation caused by another controller sending the IPC message. 

Note that most of the conditions are state- or event-sensitive; the exception is the SRQ event, 
which is level-sensitive. State-or event-sensitive events can never go unnoticed by the compu- 
ter as can service requests; the event's occurrence is "remembered" by the computer until 
serviced. 



1 This condition requires accepting data from the bus and then explicitly releasing the bus. Refer to the "Advanced Bus Management" section 
for further details. 
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For instance, if the computer is enabled to generate an interrupt on becoming addressed as a 
talker, it would interrupt the first time it received its own talk address. After having responded to 
the service request (most likely with some sort of OUTPUT operation), it would not generate 
another interrupt, even if it was still left assigned as a talker by the Active Controller. Thus, it 
would not generate another interrupt until the event occurred a second time. 

An oversimplified example of a service routine that is to respond to multiple conditions might be 
as follows. 

100 ON INTR Hpib GOSUB Seruice 

110 Ma5K = INT(2- 13) + INT(2M2) 

120 ENABLE INTR Hpib JMask ! Interrupt on receiuinS 

130 ! t a 1 K r 1 i 5 t 9 n a d d r , 

lao Idle: GOTO Idle 

15 ! 

IBO Seruice: STATUS Hp i b < ii 5 S t a t us jMas k 

170 IF BIT(Status j13) THEN Talker 

180 IF BIT(Statu.s »12) THEN Listener 

190 RETURN! I g n c r e o t h e r i ri t e r r u p t s * 

200 Talker: ! Take actio n for talker. 

210 GOTO Exit.point 

220 ! 

230 Listener: ! Take action for listener. 

240 ! 

250 Exit_point: ENABLE INTR Hpib^Mask 

2B0 RETURN 

270 END 

Register 4, the interrupt status register, is a "read-destructive" register; reading the register with 
a STATUS statement returns its contents and then clears the register (to a value of 0). If the 
service routine's action depends on the contents of STATUS register 4, the variable in which it 
is stored must not be used for any other purposes before all of the information that it contains 
has been used by the service routine. 

The computer is automatically addressed to talk (by the Active Controller) whenever it is 
Serially Polled. If interrupts are concurrently enabled for My Address Change and/or Talker 
Active, the ON INTR branch will be initiated due to the reception of the computer's talk 
address. However, since the Serial Poll is automatically finished with the Untalk Command, the 
computer may no longer be addressed to talk by the time the interrupt service routine begins 
execution. See "Responding to Serial Polls" for further details. 
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Addressing a Non-Active Controller 

The bus standard states that a non-Active Controller cannot perform any bus addressing. 
When only the interface select code is specified in an ENTER or OUTPUT statement that uses 
an HP-IB interface, no bus addressing is performed. 

If the computer currently is not the Active Controller, it can still act as either talker or listener, 
provided it has been previously addressed as such. Thus, if an ENTER or OUTPUT statement 
is executed while the computer is not an Active Controller, the computer first determines 
whether or not it is an active talker or listener. If not addressed to talk or listen, the computer 
waits until it is properly addressed and then finishes executing the statement. It relies on the 
Active Controller (another computer or device) to perform the bus addressing, and then simply 
participates as a device in the exchange of the data. Example statements which send and 
receive data while the computer is not an Active Controller are as follows. 

100 OUTPUT 7? "Data" ! If not talKer> then wait until 
110 ! addressed as talKerto send data. 

200 ENTER 7 5Data$ ! If not listener* then wait until 

210 ! addressed as listener to accept data. 

If the computer is the Active Controller, it proceeds with the data transfer without addressing 
which devices are talker and listener(s). However, if the bus has not been configured previous- 
ly, an error is reported (E r ro r 170 I/O operation not al 1 owed). The following 
program does not require the "overhead" of addressing talker and listeners each time the 
OUTPUT statement in the FOR-NEXT loop is executed, because the bus is not reconfigured 
each time. 

100 OUTPUT 701 USING "«fK" ! Configure the bus: 

110 ! 982B = tal Ke r » and 

120 ! p r inte r ( 701 ) = 1 i s tene r . 

130 ! 

lao FOR Iteration=l TO 25 

150 OUTPUT 7! "Data message" 

ISO NEXT Iteration 

170 ! 

180 END 

This type of HP-IB addressing should be used with the understanding that if an event initiates a 
branch between the time that the initial addressing was made (line 100) and the time that any of 
the OUTPUT statements are executed (line 150), the event's service routine may reconfigure 
the bus differently than the initial configuration. If so, the data will be directed to the device(s) 
addressed to listen by the last I/O statement executed in the service routine. Events may need to 
be disabled if this method of addressing is used. 

In general, most applications do not require this type of bus-overhead minimization; the com- 
puter's I/O language has already been optimized to provide excellent performance. Advanced 
methods of explicit bus management will be described in the section called "Advanced Bus 
Management". 
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Requesting Service 

When the computer is a non-Active Controller, it has the capability of sending an SRQ to the 
current Active Controller. The following statement is an example of requesting service from the 
Active Controller of the HP-IB Interface on select code 7. 

CONTROL 7 ,l',Ba 

The REQUEST statement can be used to perform the same function. 

REQUEST 7i64 

Both of the preceding example place a logic True on the SRQ line. (Note that the line may 
already be set True by another device.) Other bits may be set in the Status Byte message, 
indicating that other device-dependent conditions exist. 

The SRQ line is held True until the Active Controller executes a Serial Poll or this computer 
executes a REQUEST with bit 6 equal to 0. (Note also that the line may still be held True by 
another device.) 

When the Active Controller detects an SRQ message, it usually polls device(s) on the bus to 
determine which need(s) service and what kind of service is needed. To determine which 
device(s) are requesting service, the Active Controller conducts a Parallel Poll. If there are not 
more than one device currently capable of requesting service, the Parallel Poll is not necessary. 

The Parallel Poll is conducted by sending an Identify (ATN & EOI). This non-Active Control- 
ler's response to a Parallel Poll performed by the Active Controller depends on the current 
Parallel Poll Response set up for this controller. Setting up this controller's Parallel Poll Re- 
sponse is described in the next section. 

If the Active Controller needs to determine what service action is required for a particular 
device, it performs a Serial Poll on the device(s) that responded to the Parallel Poll with an "I 
need service." As each device is Serially Polled, it responds by placing its Status Byte on the 
bus. 

This non- Active Controller's response to a Serial Poll performed by the Active Controller is 
handled automatically by the system. The Status Byte is the byte sent to the Serial Poll Re- 
sponse Byte Register (with CONTROL or REQUEST, as shown above). A subsequent section 
further describes this non-Active Controller's responses to Serial Polls. 
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Responding to Parallel Polls 

Before performing a Parallel Poll of bus devices, the Active Controller configures selected 
device(s) to respond on one of the eight data lines. Each device is directed to respond on a 
particular data line with a logic True or False; the logic sense of the response informs the Active 
Controller either "I do need service" or "I don't need service." The logic sense of the response 
is also specified by the Active Controller. This response to the Parallel Poll is known as the 
Status Bit message. 

After the desired devices have been told how to respond, the Active Controller can send the 
Identify message and read the Status Bits placed on the data lines to determine which device(s) 
need service. Identify is sent by placing ATN and EOI in the logic True state. All devices which 
are currently configured for the poll respond as configured. 

To configure its own Parallel Poll Response, the computer must receive a Parallel Poll Confi- 
gure (PPC) command followed by a Parallel Poll Enable (PPE) command from the Active 
Controller. Receiving this "Parallel Poll Configuration Change" generates an interrupt (this 
type of interrupt is enabled by setting bit 14 of the Interrupt Enable Register). The service 
routine takes care of configuring this controller's response by first accepting the encoded 
"configure byte" (the PPE command from the Active Controller) and then setting up a corres- 
ponding response. 

The desired Status Bit message can be configured and sent by one of two methods. The first, 
and simplest, method is to define an automatic response by using the PPOLL RESPONSE 
statement. With this method, the computer reads the configure byte from the data lines (HP-IB 
STATUS Register 7) and then writes the byte's numeric value into HP-IB CONTROL Register 
5. The following statements show an example of configuring this controller's Parallel Poll 
Response. 

100 STATUS 7 >7 ;Conf i 3ure_code 

110 CONTROL 7 »5 JConf i ^ure-code 

120 I_need_seri.Jice = 

130 PPOLL RESPONSE 7 » I _ne ed_s e n.i i ce 

When the computer receives a subsequent Identify from the Active Controller, the specified 
response ("I do/don't need service") is automatically sent to the Active Controller. The compu- 
ter will probably need to respond to a Serial Poll, which is described in the next section. 

The second method requires that the service routine decode the configure byte and set up the 
corresponding response. The configure byte read from HP-IB STATUS Register 7 contains 5 
bits of data encoded with the following information: 



Control Register 5 

Most Significant Bit 








Parallel Poll Response Mask 

Least Significant Bit 


Bit? 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


BitO 


Not 
Used 


Uncon- 
figure 


Logic 
Sense 


Data Bit Used 
For Response 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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Bit 4 determines whether a response will or will not be configured. A 1 tells this controller not to 
configure a response, and a tells the controller to configure a response. 

Bit 3 determines the logic sense of the Status Bit. If this bit is 0, then the "1 need service" 
message is a 0; if this bit is 1, the "1 need service" message is 1. 

Bits 2 through determine the data line on which the Status Bit is to be placed. For instance, if 
these bits are "000", then the Status Bit is to be placed on DIOl. If these bits are "111", then 
the response is to be placed on D108. 

The service routine calculates the desired response and places the appropriate bit pattern in 
HP-IB CONTROL Register 2. For instance, if the configure byte has a value of 12 (positive-true 
logic on DI05 for "1 need service"), the value sent to CONTROL Register 2 is 16 for "1 need 
service." The appropriate statement might be: 

CONTROL 7 ,2; IB 

When the Identify is received from the Active Controller, the specified response is made 
automatically. 

As another example, suppose that the configure byte has a value of 7. The Status Bit to be 
written into DI08 would be a for "1 need service." The corresponding statement might be: 

CONTROL 7»2;0 

The following general routine calculates the value to be sent to CONTROL Register 2: 



79( 
8 ( 
SIC 
82( 
83( 
8^( 
85<: 
8G0 
870 
88 C 
B3( 



STATUS 7 »7 ;Corif 1 ^_code ! Read data lines. 

Conf i 3_code=CQnf i S_code MOD 25B ! Strip 8 MSBs. 

Un c n f i tf = B I T ( C n f i S.. c d e * a ) 

Sen5e = BIT(CorifiS_code f3) 

IF UncorifiS=l OR Sen5e = THEN ! Un c on f i 3u r e . 

Ppoll_response=0 
ELSE ! Configure. 

Statu5_bit=Confi3_code 



MOD 8 ! 



Ppoll_respon 56 = 2 ■'Status- bit 
END IF 
CONTROL 7 »2 ;PpoI l.response 



Get bits 2 - . 
Set proper bit. 
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Responding to Serial Polls 

As a non-Active Controller, the response to Serial Polls is automatically hanciled by the system. 
The desired Serial Poll Response Byte is sent to HP-IB CONTROL Register 1. If bit 6 is set (bit 6 
has a value of 64), an SRQ is indicated from this controller. All other bits can be considered to 
be "device-dependent," and can thus be set according to the program's needs. 

The following statement sets up a response with SRQ and bits 1 and set to I's. 

CONTR(DL 7 tl 5B4 + 2 + 1 

When the Active Controller performs a Serial Poll on this non-Active Controller, the specified 
byte is automatically sent to the Active Controller by the system. 

This non-Active Controller is automatically addressed to talk by the Active Controller during a 
Serial Poll. If interrupts are concurrently enabled for My Address Change and/or Talker Active 
interrupts, the ON INTR branch will be initiated due to the reception of this controller's talk 
address. However, since the Serial Poll Response is terminated with the Untalk command, this 
controller may no longer be addressed to talk when the service routine begins its execution. In 
such a case, the SPAS interrupt (if enabled) will also be indicated. If desired, the interrupt may 
be ignored. 

Interface-State Information 

It is often necessary to determine which state the interface is in. STATUS register 6 contains 
interface-state information in its upper byte; it also contains the same information as STATUS 
register 3 in its lower byte. In advanced applications, it may be necessary to detect and act on 
the interface's current state. Register 6's definition is shown below. 



Status Register 6 

Most Significant Bit 










Interface Status 


Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bit 8 


REM 


LLO 


ATN 
True 


LPAS 


TPAS 


LADS 


TADS 


• 


Value = 
-32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 



Most Significant Bit 












Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


System 
Controller 


Active 
Controller 





Primary Address of Interface 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 


2 


Value = 1 



Least-significant bit of last address recognized 
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Bit 15 set indicates that the interface is in the Remote state. 

Bit 14 set indicates that the interface is in the Local Lockout state. 

Bit 13 set indicates that the ATN line is currently set (true). 

Bit 12 set indicates that the interface is in the Listener Primary Addressed State (has received its 
primary listen address). 

Bit 11 set indicates that the interface is in the Talker Primary Addressed State (has received its 
primary talk address). 

Bit 10 set indicates that the interface is in the Listener Addressed State and is currently an 
active listener. If Bit 4 of the Interrupt Enable register is set (Secondary Command While 
Addressed), two additional conditions are required to enter this state: the interface must have 
first received its own primary address followed by a secondary command, and it must have 
accepted the secondary command (by writing a non-zero value to CONTROL register 4 to 
release the NDAC Holdoff). 

Bit 9 set indicates that the interface is in the Talker Addressed State and is currently an active 
talker. This state is entered in a manner analogous to the Listener Addressed State (see Bit 10 
above). 

Bit 8 contains the least-significant bit of the last address recognized by this interface. 
Bits 7 through have the same definitions as STATUS register 3. 
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Servicing Interrupts that Require Data Transfers 

During the discussion on interrupts, three special types of interrupt conditions were described 
(which are enabled by setting bits in CONTROL register 4). These interrupts occur upon 
receiving: an unrecognized Universal Command, an unrecognized Addressed Command, or a 
Secondary Command. These situations all require the computer to read a byte of information 
from the bus and respond as desired by the programmer. 



Status Register 4 

Most Significant Bit 



Interrupt Status 

Least Significant Bit 



Bit 15 


Bit 14 


... 

Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bits 


Active 
Controller 


Parallel 

Poll 

Configuration 

Change 


My Talk 
Address 
Received 


My Listen 
Address 
Received 


EOl 
Received 


SPAS 


Remote/ 

Local 

Change 


Talker/ 
Listener 
Address 
Change 


Value = 
-32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 0&6 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 



Least Significant Bit 



Bit? 


Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit© 


Trigger 
Received 


Handshake 
Error 


Unrecognized 
Universal 
Command 


Secondary 
Command 

While 
Addressed 


Clear 
Received 


Unrecognized 
Addressed 
Command 


SRQ 
Received 


IPC 
Received 


Value =128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



As a reminder, these interrupt conditions occur under the following circumstances. 

Bit 14 enables an interrupt on any change in Parallel Poll configuration. If a Parallel Poll 
Configure command is received, the computer must set up its own Parallel Poll Response 
designated by the Active Controller. The response itself is set up by writing to CONTROL 
register 2 of the HP-IB interface. 

Bit 5 enables an interrupt upon receiving an unrecognized Universal Command. This interrupt 
condition provides the computer with the ability to respond to new definitions that may be 
adopted by the IEEE standards committee. 

Bit 4 enables an interrupt upon receiving a Secondary Command, if addressed to either talk or 
listen during the command mode. Again, this allows the computer to detect and respond to 
special information from another controller. 



Bit 2 enables an interrupt upon receiving an unrecognized Addressed Command, if addressed 
to listen. This interrupt is used to detect and respond to commands that are undefined by the 
standard (but which may be recognized by the computer). 
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Whenever any of the above interrupt conditions are enabled and occur, the computer logs the 
interrupt and then sets a bus holdoff. In other words, all bus activity is "frozen" until the 
program has released this holdoff. The holdoff is established to allow the program time to 
determine the current state of the bus. 

The bus state is determined by reading HP-IB STATUS register 7, which returns the current 
logic state of the data and control lines as a 16-bit integer. 

STATUS 7 »7;Bu5_liries 

After reading the state of the lines, it is necessary to release the bus holdoff by writing any value 
into HP-IB CONTROL register 4. 

CONTROL 7 ,a;Any_ualLie 



Control Register 4 

Most Significant Bit 








Release NDAC Holdoff 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


= Don't Accept Secondary Command 

All Non-zero Values Accept Secondary 

(Writing anything to this register releases NDAC holdoff) 


Value- 128 


Value - 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



When a Secondary Command is received, two computer responses are possible. The first is to 
accept the address as a valid secondary address and consequently become an Extended Talker 
or Listener. The second is not to accept the address as valid and consequently remain in the 
primary addressed state. 

If Secondary Command interrupts are enabled (while the computer is a non-Active Controller), 
the computer will not respond to its primary address alone; a valid secondary address is also 
required. Statements such as ENTER 7, OUTPUT 7, and LIST #7 should only be executed in 
the interrupt service routine after CONTROL has been used to indicate that a valid secondary 
address has been received but before interrupts are re-enabled. 

When you no longer want the computer to respond as an Extended Talker/Listener, execute an 
ENABLE INTR with a mask which has bit 4 equal to zero. 
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HP-IB Control Lines 



Device A 

Able to talk, 
listen, and 
control 

(e.g., 
HP 9826) 



Device B 

Able to talk 
and listen 

(e.g., 
multimeter) 



< 



muiiS] 



< 



C)' 



Data Bus 

(8 signal lines) 



Device C 

Only able to 
listen 

(e.g., signal 
generator) 



K 



m 



r 



s 



Handshake Lines 
(3 signal lines) 



K 



Device D 

Only able to 
talk 

(e.g., counter) 



.) 



Bus Lines 
(5 signal lines) 



Lb} 01 



O 1.8 



DAV 
NRFD 

■ NDAC 
• IFC 
■ATN 
•SRQ 
■REN 

■ EOl 



Handshake Lines 

The preceding figure shows the names given to the eight control lines that make up the HP-IB. 
Three of these lines are designated as the "handshake" lines and are used to control the timing 
of data byte exchanges so that the talker does not get ahead of the listener(s). The three 
handshake lines are as follows. 

DAV Data Valid 

NRFD Not Ready for Data 

NDAC Not Data Accepted 
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The HP-IB interlocking handshake uses the lines as follows. All devices currently designated 
as active listeners would indicate when they are ready for data by using the NRFD line. A device 
not ready would pull this line low (true) to signal that it is not ready for data, while any device 
that is ready would let the line float high. Since an active low overrides a passive high, this line 
will stay low until all active listeners are ready for data. 

When the talker senses that all devices are ready, it places the next data byte on the data lines 
and then pulls DAV low (true). This tells the listeners that the information on the data lines is 
valid and that they may read it. Each listener then accepts the data and lets the NDAC line float 
high (false). As with NRFD, only when all listeners have let NDAC go high will the talker sense 
that all listeners have read the data. It can then float DAV (let it go high) and start the entire 
sequence over again for the next byte of data. 

The Attention Line (ATN) 

Command messages are encoded on the data lines as 7-bit ASCII characters, and are distin- 
guished from normal data characters by the logic state of the attention line (ATN). That is, when 
ATN is false, the states of the data lines are interpreted as data. When ATN is true, the data 
lines are interpreted as commands. The set of 128 ASCII characters that can be placed on the 
data lines during this ATN-true mode are divided into four classes by the states of data lines 
DI06 and DI07. These classes of commands are shown in a table in the section called "Adv- 
anced Bus Management". Only the Active Controller can set ATN true. 

The Interface Clear Line (IFC) 

Only the System Controller can set the IFC line true. By asserting IFC, all bus activity is 
unconditionally terminated, the System Controller regains the capability of Active Controller (if 
it has been passed to another device), and any current talker and listeners become unaddres- 
sed. Normally, this line is only used to terminate all current operations, or to allow the System 
Controller to regain control of the bus. It overrides any other activity that is currently taking 
place on the bus. 

The Remote Enable Line (REN) 

This line is used to allow instruments on the bus to be programmed remotely by the Active 
Controller. Any device that is addressed to listen while REN is true is placed in the Remote 
mode of operation. 

The End or Identify Line (EOI) 

Normally, data messages sent over the HP-IB are sent using the standard ASCII code and are 
terminated by the ASCII line-feed character, CHR$(10). However, certain devices may wish to 
send blocks of information that contain data bytes which have the bit pattern of the line-feed 
character but which are actually part of the data message. Thus, no bit pattern can be desig- 
nated as a terminating character, since it could occur anywhere in the data stream. For this 
reason, the EOI line is used to mark the end of the data message. 
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The EOI line is used as an END indication (ATN false) during ENTER statements and as the 
Identify message (ATN true) during an identify sequence (the response to parallel poll). During 
data messages, the EOI line is set true by the talker to signal that the current data byte is the last 
one of the data transmission. Generally, when a listener detects that the EOI line is true, it 
assumes that the data message is concluded. However, EOI may either be used or ignored by 
the computer when entering data with an ENTER statement that uses an image. Chapter 5 fully 
describes the definitions of EOI during all ENTER statements and shows how to use the image 
specifiers that modify the statement-termination conditions. 

ENTER statements can use images to re-define the meaning of EOI to provide a very great 
degree of flexibility. Using the "%" specifier in an ENTER statement affects the definition of the 
EOI signal as shown in the following table. 

Definition of EOI During ENTER Statements 





Free-field 

ENTER 

statements 


ENTER statements that use an image: 




without 
"«" or "X" 


with "«" 


with "Z" 


Definition 
of EOI 


Immediate 
statement 
terminator 


Item 

terminator 

or statement 

terminator 


Item 

terminator 

or statement 

terminator 


Immediate 
statement 
terminator 


Statement 

terminator 

required? 


Yes 


Yes 


No 


No 


Early 

termination 

allowed? 


No 


No 


No 


Yes 



The Service Request Line (SRQ) 

The Active Controller is always in charge of the order of events that occur on the HP-IB. If a 
device on the bus needs the Active Controller's help, it can set the Service Request line true. 
This line sends a request, not a demand, and it is up to the Active Controller to choose when 
and how it will service that device. However, the device will continue to assert SRQ until it has 
been "satisfied". Exactly what will satisfy a service request depends on the requesting device, 
which is explained in the device's operating manual. 

Determining Bus-Line States 

STATUS register 7 contains the current states of all bus hardware lines. Reading this register 
returns the states of these lines in the specified numeric variable. 



STATUS Hpib »7;Bus_lines 
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Status Register 7 



Bus Control and Data Lines 



Most Significant Bit 














Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bit 8 


ATN 
True 


DAV 
True 


NDAC* 
True 


NRFD* 
True 


^1 
True 


SRQ** 
True 


IPC 

True 


REN 
True 


Value - 
- 32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 















Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


DI08 


DI07 


DI06 


DI05 


DI04 


DI03 


DI02 


DI01 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value 4 


Value = 2 


Value = 1 



Only if addressed to TALK, else not valid. 
Only if Active Controller, else not valid. 



Note 

Due to the way the bi-directional buffers work, NDAC and NRFD are 
not accurately read by this STATUS statement unless the interface is 
currently addressed to talk. Also, SRQ is not accurately shown unless 
the interface is currently the active controller. 
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HP-IB Status and Control Registers 



Status Register 
Control Register 
Status Register 1 

Most Significant Bit 



Card identification = 1 
Reset interface if non-zero 



Interrupt and DMA Status 



Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit0 


Interrrupts 
Enabled 


Interrupt 
Requested 


Hardware Interrupt 
Level Switches- 








DMA 

Channel 1 

Enabled 


DMA 

Channel 

Enabled 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 1 

Most Significant Bit 








Seri 


al Poll Response Byte 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Device 

Dependent 

Status 


SRQ 
1 = 1 did it 
= 1 didn't 


Device Dependent Status 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Status Register 2 

Most Significant Bit 










Busy Bits 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 














Reserved 

For Future 

Use 


Handshake 

In 

Progress 


Interrupts 
Enabled 


TRANSFER 

In 

Progress 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control F^egister 2 

Most Significant Bit 



Parallel Poll Response Byte 

Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


DI08 
1 = True 


DI07 
1 = True 


Dioe 

1 = True 


DIGS 
1 = True 


DI04 
1 = True 


DIGS 
1 = True 


DI02 
1 = True 


DI01 
1 = True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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HP-IB Status and Control Registers (cont.) 



Status Register 3 

Most Significant Bit 



Controller Status and Address 

Least Significant Bit 



Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


System 
Controller 


Active 
Controller 





Primary Address of Interface 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 3 

Most Significant Bit 



Set My Addrress 

Least Significant Bit 



Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit© 


Not Used 


Primary Address 


Value = 128 


Value - 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Status Register 4 

Most Significant Bit 



Interrupt Status 



Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bit 8 


Active 
Controller 


Parallel 

Poll 

Configuration 

Change 


My Talk 
Address 
Received 


My Listen 
Address 
Received 


EOl 
Received 


SPAS 


Remote/ 

Local 
Change 


Talker/ 
Listener 
Address 
Change 


Value = 
-32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 



Least Significant Bit 



Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Trigger 
Received 


Handshake 
Error 


Unrecognized 
Universal 
Command 


Secondary 
Command 

While 
Addressed 


Clear 
Received 


Unrecognized 
Addressed 
Command 


SRQ 
Received 


IPC 
Received 


Value- 128 


Value - 64 


Value - 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 4 



Writing anything to this register releases NDAC holdoff. If non-zero, 
accept last secondary address as valid. If zero, don't accept last secon- 
dary address (stay in LPAS or TPAS state). 
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HP-IB Status and Control Registers (cont.) 



Status Register 5 

Most SignHicant Bit 



Interrupt Enable Mask 



Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bit 8 


Active 
Controller 


Parallel 

Poll 

Configuration 

Change 


My Talk 
Address 
Received 


My Listen 
Address 
Received 


EOl 
Received 


SPAS 


Remote/ 

Local 
Change 


Talker/ 
Listener 
Address 
Change 


Value = 
- 32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 



Least Significant Bit 



Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit© 


Trigger 
Received 


Handshake 
Error 


Unrecognized 
Universal 
Command 


Secondary 
Command 

While 
Addressed 


Clear 
Received 


Unrecognized 
Addressed 
Command 


SRQ 
Received 


IPC 
Received 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 5 

\^ost Significant Bit 








Parallel Poll Response Mask 

Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Not 
Used 


Uncon- 
figure 


Logic 
Sense 


Data Bit Used 
For Response 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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HP-IB Status and Control Registers (cont.) 



Status Register 6 



Interface Status 



Most Significant Bit 














Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bits 


REM 


LLO 


ATN 

True 


LPAS 


TPAS 


LADS 


TADS 


• 


Value = 
- 32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 



Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


System 
Controller 


Active 
Controller 





Primary Address of Interface 


Value = 128 


Value = 64 


Value = 32 


Valuer 16 


Value = 8 


Value -= 4 


Value = 2 


Value = 1 



* Least-significant bit of last address recognized 



Status Register 7 



Bus Control and Data Lines 



Most Significant Bit 














Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bits 


ATN 
True 


DAV 

True 


NDAC* 
True 


NRFD* 
True 


EOl 
True 


SRQ** 
True 


IPC 

True 


REN 
True 


Value = 
-32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 















Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI08 


DI07 


DI06 


DI05 


DI04 


DI03 


DI02 


DI01 


Value = 128 


Value - 64 


Value - 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value - 1 



* Only if addressed to TALK, else not valid. 
** Only if Active Controller, else not valid. 
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HP-IB Status and Control Registers (cont.) 



Interrupt Enable Register (ENABLE INTR) 

Most Significant Bit 


" 








Bit 15 


Bit 14 


Bit 13 


Bit 12 


Bit 11 


Bit 10 


Bit 9 


Bits 


Active 
Controller 


Parallel 

Poll 

Configuration 

Change 


My Talk 
Address 
Received 


My Listen 
Address 
Received 


EOl 
Received 


SPAS 


Remote/ 

Local 
Change 


Talker/ 
Listener 
Address 
Change 


Value = 
-32 768 


Value = 
16 384 


Value = 
8 192 


Value = 
4 096 


Value = 
2 048 


Value = 
1 024 


Value = 
512 


Value = 
256 



Least Significant Bit 



Bit 7 


Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Trigger 
Received 


Handshake 
Error 


Unrecognized 
Universal 
Command 


Secondary 
Command 

While 
Addressed 


Clear 
Received 


Unrecognized 
Addressed 
Command 


SRQ 
Received 


IPC 
Received 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



250 The HP-IB Interface 



Summary of HP-IB READIO and WRITEIO Registers 

READIO Registers 

Register 1 — Card Identification 
Register 3 — Interrupt and DMA Status 
Register 5 — Controller Status and Address 
Register 17 — Interrupt Status 0' 
Register 19 — Interrupt Status 1' 
Register 21 — Interface Status 
Register 23 — Control-Line Status 
Register 29 — Command Pass-Through 
Register 31 — Data-Line Status^ 



HP-IB READIO Register 1 



Card Identification 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Future Use 
Jumper 
Installed 




















1 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 is set (1) if the "future use" jumper is installed and clear (0) if not. 

Bits 6 through constitute a card identification code ( = 1 for all HP-IB cards). 



Note 

This register is only implemented on external HP-IB cards. The inter- 
nal HP-IB, at interface select code 7, "floats" this register (i.e., the 
states of all bits are indeterminate). 



HP-IB READIO Register 3 

Most Significant Bit 






Interrupt and DMA Status 

Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit© 


Interrupt 
Enabled 


Interrupt 
Request 


Interrupt 
Level 


X 


X 


DMA1 


DMA0 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



1 Indicates that a READIO operation will change the state of the interface. 
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Bit 7 is set (1) if interrupts are currently enabled. 

Bit 6 is set (1) when the card is currently requesting service. 

Bits 5 and 4 constitute the card's hardware interrupt level (a switch setting on all external cards, 
but fixed at level 3 on the internal HP-IB). 



Bits 


Bit 4 


Hardware Interrupt 
Level 





1 
1 



1 


1 


3 
4 
5 
6 



Bits 3 and 2 are not used (indeterminate). 

Bit 1 is set (1) if DMA channel one is currently enabled. 

Bit is set (1) if DMA channel zero is currently enabled. 



Note 

Bits 7, 5, 4, 3, 2, and 1 are not implemented on the internal HP-IB 
(interface select code 7). 



HP-IB READIO Register 5 

Most Significant Bit 






Controller Status and Address 

Least Significant Bit 


Bit? 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


System 
Controller 


Not 

Active 

Controller 


X 




- HP-IB Primary Address of Interface - 




(MSB) 


(LSB) 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 is set (1) if the interface is the System Controller. 

Bit 6 is set (1) if the interface is not the current Active Controller and clear (0) if it is the Active 
Controller. 

Bit 5 is not used. 

Bits 4 through contain the card's Primary Address switch setting. The following bit patterns 
indicate the specified addresses. 
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Bit 
4 3 2 10 



Primary 
Address 




1 

1110 1 
11110 

11111 





1 

29 

30 

(not allowed) 



Note 

Bits 5 through are not implemented on the internal HP-IB. 



HP-IB READIO Register 17 

Most Significant Bit 






MSB of Interrupt Status 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


MSB 
Interrupt 


LSB 
Interrupt 


Byte 
Received 


Ready 

for Next 

Byte 


End 
Detected 


SPAS 


Remote/ 

Local 
Change 


My 
Address 
Change 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 set (1) indicates that an interrupt has occurred whose cause can be determined by reading 
the contents of this register. 

Bit 6 set (1) indicates that an interrupt has occurred whose cause can be determined by reading 
Interrupt Status Register 1 (READIO Register 19). 

Bit 5 set (1) indicates that a data byte has been received. 

Bit 4 set (1) indicates that this interface is ready to accept the next data byte. 

Bit 3 set (1) indicates that an End (EOI with ATN = 0) has been detected. 

Bit 2 set (1) indicates that the Serial-Poll-Active State has been entered. 

Bit 1 set (1) indicates that a Remote/Local State change has occurred. 

Bit set (1) indicates that a change in My Address has occurred. 



HP-IB READIO Register 19 

Most Significant Bit 
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LSB of Interrupt Status 

Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


BitO 


Trigger 
Received 


Handslial<e 
Error 


Unrecognized 

Command 

Group 


Secondary 
Command 

While 
Addressed 


Clear 
Received 


My Address 

Received 

(MLAorMTA) 


SRQ 
Received 


IFC 
Received 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 set (1) indicates that a Group Execute Trigger command has been received. 

Bit 6 set (1) indicates that an Incomplete-Source-Handshake error has occurred. 

Bit 5 set (1) indicates that an unidentified command has been received. 

Bit 4 set (1) indicates that a Secondary Address has been sent in while in the extended- 
addressing mode. 

Bit 3 set (1) indicates that the interface has entered the Device-Clear-Active State. 

Bit 2 set (1) indicates that My Address has been received. 

Bit 1 set (1) indicates that a Service Request has been received. 

Bit set (1) indicates that the Inteface Clear message has been received. 



HP-IB READIO Register 21 

\^ost Significant Bit 








Interface Status 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


REM 


LLO 


ATN 
True 


LPAS 


TPAS 


LADS 


TADS 


LSBof 

Last 
Address 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 set (1) 
Bit 6 set (1) 
Bit 5 set (1) 
Bit 4 set (1) 
Bit 3 set (1) 
Bit 2 set (1) 
Bit 1 set (1) 

Bit set (1) 

interface. 



ndicates that this Interface is in the Remote State. 

ndicates that this interface is in the Local Lockout State. 

ndicates that the ATN signal line is true. 

ndicates that this interface is in the Listener-Primary-Addressed State. 

ndicates that this interface is in the Talker-Primary-Addressed State. 

ndicates that this interface is in the Listener-Addressed State. 

ndicates that this interface is in the Talker-Addressed State. 

indicates that this is the least-significant bit of the last address recognized by this 
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HP-IB READIO Register 23 

Most Significant Bit 








Control-Line Status 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


ATN 
True 


DAV 
True 


NDAC* 
True 


NRFD* 
True 


EOl 
True 


SRQ** 
True 


IPC 
True 


REN 
True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



"Only if addressed to TALK, else not valid. 
**Only if Active Controller, else not valid 

A set bit (1) inciicates that the corresponding line is currently true; a inciicates that the line is 
currently false. 



HP-IB READIO Register 29 



Command Pass-Through 

Least Significant Bit 



Bit? 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI08 


DI07 


DI06 


DI05 


DI04 


DI03 


DI02 


DI01 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



This register can be read during a bus holdoff to determine which Secondary Command has 
been detected. 



HP-IB READIO Register 31 

\/1ost Significant Bit 








Bus Data Lines 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI08 


DI07 


DI06 


DIGS 


DI04 


DI03 


DI02 


DI01 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



A set bit (1) indicates that the corresponding HP-IB data line is currently true; a indicates the 
line is currently false. 
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HP-IB WRITEIO Registers 

Register 3 — Interrupt Enable 
Register 17 — MSB of Interrupt Mask 
Register 19 — LSB of Interrupt Mask 
Register 23 — Auxiliary Command Register 
Register 25 — Address Register 
Register 27 — Serial Poll Response 
Register 29 — Parallel Poll Response 
Register 31 — Data Out Register 



HP-IB WRITEIO Register 3 

Most Significant Bit 






Interrupt and DMA Enable 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Enable 
Interrupt 


X 


X 


X 


X 


X 


Enable 
Channel 1 


Enable 
Channel 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 enables interrupts from this interface if set (1) and disables interrupts if clear (0). 

Bits 6 through 2 are "don't cares" (i.e., their values have no effect on the interface's opera- 
tion). 

Bit 1 enables DMA channel 1 if set (1) and disables if clear (0). 

Bit enables DMA channel if set (1) and disables if clear (0). 



Note 

Bits 7 through 1 are not implemented on the internal HP-IB interface 
and thus have no effect on the interface's operation. 



WRITEIO Register 17 MSB of Interrupt Mask 

Setting a bit of this register enables an interrupt for the specified condition. The bit assignments 
are the same as for the MSB of Interrupt Status Register (READIO Register 17), except that bits 
7 and 6 are not used. 

WRITEIO Register 19 LSB of Interrupt Mask 

Setting a bit of this register enables an interrupt for the specified condition. The bit assignments 
are the same as for the LSB of Interrupt Status Register (READIO Register 19). 



256 The HP-IB Interface 



HP-IB WRITEIO Register 23 

Most Significant Bit 






Auxiliary Command Register 

Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Set 


X 


X 


Auxiliary Command Function 


Valuer 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 is set (1) for a Set operation and clear (0) for a Clear operation. 
Bits 6 and 5 are "don't cares". 

Bits 4 through are Auxiliary-Command-Function-Select bits. The following commands can 
be sent to the interface by sending the specified numeric values. 



Decimal 
Value 

- 

128 - 

1 

129 - 

2 - 

130 - 

3 

131 - 

4 
132 

5 
133 



134 

7 
135 



8 
136 

9 
137 

10 
138 



Description of 
Auxiliary Command 

— Clear Chip Reset. 

— Set Chip Reset. 

— Release ACDS holdoff. If Address Pass Through is set, it indicates an invalid second- 
ary has been received. 

— Release ACDS holdoff; If Address Pass Through is set, indicates a valid secondary 
has been received. 

— Release RFD holdoff. 

— Same command as decimal 2 (above). 

— Clear holdoff on all data. 

— Set holdoff on all data. 

— Clear holdoff on EOI only. 

— Set holdoff on EOI only. 

— Set New Byte Available (nba) false. 

— Same command as decimal 5 (above). 

— Pulse the Group Execute Trigger line, or clear the line if it was set by decimal 
command 134. 

— Set Group Execute Trigger line. 

— Clear Return To Local (rtl). 

— Set Return To Local (must be cleared before the device is able to enter the Remote 
state). 

— Causes EOI to be sent with the next data byte. 

— Same command as decimal 8 (above). 

— Clear Listener State (also cleared by decimal 138). 

— Set Listener State. 

— Clear Talker State (also cleared by decimal 137). 

— Set Talker State. 

(Continued) 
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Decimal 
Value 

11 - 

139 - 

12 - 

140 - 

13 - 

141 - 

14 - 

142 - 

15 - 

143 ■ 

16 ■ 

144 ■ 

17 

145 
18 

146 — 

19 

147 

20 
148 

21 
149 

22 
150 



Description of 
Auxiliary Command 

Go To Standby (gts; controller sets ATN false). 
Same command as decimal 11 (above). 

Take Control Asynchronously (tea; ATN true). 
Same command as decimal 12 (above). 

Take Control Synchronously (tcs; ATN true). 
Same command as decimal 13 (above). 

Clear Parallel Poll. 

Set Parallel Poll (read Command-Pass-Through register before clearing). 

Clear the Interface Clear line (IFC). 

Set Interface Clear (IFC maintained >100 |jls). 

Clear the Remote Enable (REN) line. 
Set Remote Enable. 

Request control (after TCT is decoded, issue this to wait for ATN to drop and receive 

control). 

Same command as decimal 17 (above). 

Release control (issued after sending TCT to complete a Pass Control and set ATN 

false). 

Same command as decimal 18 (above). 

Enable all interrupts. 
Disable all interrupts. 

Pass Through next Secondary Command. 
Same command as decimal 20 (above). 

Set Tl delay to 10 clock cycles (2 jis at 5 MHz). 
Set Tl delay to 6 clock cycles (1.2 pts at 5 MHz). 

Clear Shadow Handshake. 
Set Shadow Handshake. 
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HP-IB WRITEIO Register 25 



Most Significant Bit 



Address Register 

Least Significant Bit 



Bit? 


Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Enable 

Dual 

Addressing 


Disable 
Listen 


Disable 
Talker 


Primary Address 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 set (1) enables the Dual-Primary-Addressing Mode. 

Bit 6 set (1) invokes the Disable-Listen function. ' 

Bit 5 set ( 1 ) invokes the Disable-Talker function 

Bits 4 through set the device's Primary Address (same address bit definitions as READIO 
Register 5). 



HP-IB WRITEIO Register 27 

Most Significant Bit 



Serial Poll Response Byte 

Least Significant Bit 



Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Device 

Dependent 

Status 


Request 
Service 


Device-Dependent Status 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bits 7 and 5 — specify the Device-Dependent Status. 
Bit 6 sends an SRQ if set (1). 



Note 

Given an unknown state of the Serial Poll Response Byte, it is neces- 
sary to write the byte with bit 6 set to zero followed by a write of the 
byte with bit 6 set to the desired final value. This will insure that a 
SRQ will be generated if one was desired. 
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HP-IB WRITEIO Register 29 

Most Significant Bit 






Parallel Poll Response 

Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI08 


DI07 


DI06 


DI05 


DI04 


DI03 


DI02 


DI01 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



A 1 sets the appropriate bit true during a Parallel Poll; a sets the corresponding bit false. 
Initially, and when Parallel Poll is not configured, this register must be set to all zeros. 



HP-IB WRITEIO Register 31 

l^ost Significant Bit 








Data-Out Register 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


BitO 


DI08 


DI07 


DI06 


DI05 


DI04 


DI03 


DI02 


DI01 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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Summary of Bus Sequences 



The following tables show the bus activity invoked by executing HP-IB statements and func- 
tions. The mnemonics used in these tables were defined in the previous section of this chapter. 

Note that the bus messages are sent by using single lines (such as the ATN line) and multi-line 
commands (such as DCL). The information shows the state of and changes in the state of the 
ATN line during these bus sequences. The tables implicitly show that these changes in the 
state of ATN remain in effect unless another change is explicitly shown in the table. For 

example, if a statement sets ATN (true) with a particular command, it remains true unless the 
table explicitly shows that it is set false (ATN). The ATN line is implememted in this manner to 
avoid unnecessary transitions in this signal whenever possible. It should not cause any dilem- 
mas in most cases. 

ABORT 





System Controller 


Not System Controller | 


Interface Select 
Code Only 


Prinnary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


IFC (duration 

s=100|xsec) 
REN 
ATN 


Error 


ATN 
MTA 
UNL 
ATN 


Error 


Not Active 
Controller 


IFC (duration 

&100 ^.sec)* 
REN 
ATN 


No 
Action 



The IFC message allows a non-active controller (whicfi is the system controller) to become the active controller. 



CLEAR 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


ATN 
DCL 


ATN 
MTA 
UNL 
LAG 
SDC 


ATN 
DCL 


ATN 
MTA 
UNL 
LAG 
SDC 


Not Active 
Controller 


Error 
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LOCAL 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


REN 
ATN 


ATN 
MTA 
UNL 
LAG 
GTL 


ATN 
GTL 


ATN 
MTA 
UNL 
LAG 
GTL 


Not Active 
Controller 


REN 


Error 


Error 



LOCAL LOCKOUT 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


ATN 

LLO 


Error 


ATN 
LLO 


Error 


Not Active 
Controller 


Error 



PASS CONTROL 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 

1 


Active 
Controller 


Error 


ATN 
TAD 
TCT 
ATN 


Error 


ATN 
TAD 
TCT 
ATN 


Not Active 
Controller 


Error 
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PPOLL 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


ATN & EOl 

(duratlona25(xs) 

Read byte 

EOl 

Restore ATN to 

previous state 


Error 


ATN & EOl 

(durations25jjis) 

Read byte 

EOl 

Restore ATN to 

previous state 


Error 


Not Active 
Controller 


Error 



PPOLL CONFIGURE 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


Error 


ATN 
MTA 
UNL 
LAG 
PPC 
PPE 


Error 


ATN 
MTA 
UNL 
LAG 
PPC 
PPE 


Not Active 
Controller 


Error 



PPOLL UNCONFIGURE 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


ATN 
PPU 


ATN 
MTA 
UNL 
LAG 
PPC 
PPD 


ATN 
PPU 


ATN 
MTA 
UNL 
LAG 
PPC 
PPD 


Not Active 
Controller 


Error 
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REMOTE 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


REN 
ATN 


REN 
ATN 
MTA 
UNL 
LAG 


Error 


Not Active 
Controller 


REN 


Error 


Error 



SPOLL 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


Error 


ATN 
UNL 
MLA 
TAD 
SPE 
ATN 
Read data 
ATN 
SPD 
UNT 


Error 


ATN 
UNL 
MLA 
TAD 
SPE 
ATN 
Read data 
ATN 
SPD 
UNT 


Not Active 
Controller 


Error 



TRIGGER 





System Controller 


Not System Controller 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Interface Select 
Code Only 


Primary Addressing 
Specified 


Active 
Controller 


ATN 
GET 


ATN 
UNL 
LAG 
GET 


ATN 
GET 


ATN 
MTA 
UNL 
LAG 
GET 


Not Active 
Controller 


Error 
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The Datacomm Interface 



Chapter 

13 



Introduction 

The HP 98628 Data Communications Interface enables your Series 200/300 computer to com- 
municate with any device that is compatible with standard asynchronous or HP Data Link data 
communication protocols. Devices can include various modems or link adapters, as well as equip- 
ment with standard RS-232C or current loop links. 

This chapter discusses both asynchronous and Data Link protocols, and provides useful prog- 
ramming techniques so you can quickly create working programs. Subject areas that are similar 
for both protocols are combined, while information that is unique to one protocol or the other is 
separated according to application. 

Prerequisites 

It is assumed that you are familiar with the information presented in Data Communication 
Basics, and that you understand data communication hardware well enough to determine your 
needs when configuring the datacomm link. Configuration parameters include such items as 
half/full duplex, handshake, and timeout requirements. If you have any questions concerning 
equipment installation or interconnection, consult the appropriate interface or adapter installa- 
tion manuals. 

The datacomm interface supports several cable and adapter options. They include: 

• RS-232C Interface cable and connector wired for operation with data communication 
equipment (male cable connector) or with data terminal equipment (female cable con- 
nector). 

• HP 13264A Data Link Adapter for use in HP 1000- or HP 3000-based Data Link network 
applications 

• HP 13265A Modem for asynchronous connections up to 300 baud, including built-in 
autodial capability^ 

• HP 13266A Current Loop Adapter for use with current loop links or devices. 

Some of the information contained in this chapter pertains directly to certain of these devices in 
specific applications. 



1 The HP 13265A modem is compatible with Bell 103 and Bell 113 Modems, and is approved for use in the USA and Canada. Most other 
countries do not allow use of user-owned modems. Contact your local HP Sales and Service office for information about local regulations. 
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Before you begin datacomm operation, be sure all interfaces, cables, connectors, and equip- 
ment have been properly plugged in. Power must be on for all devices that are to be used. 
Consult applicable installation manuals if necessary. 

Protocol 

Two protocols are switch selectable on the datacomm interface. They are also software select- 
able during normal program operation. The switch setting on the interface determines the 
default protocol when the computer is first powered up. Protocol is changed between Async 
and Data Link during program operation by selecting the new protocol, waiting for the message 
to reach the card, then resetting the card. The exact procedure is explained in "Protocol 
Selection". 

Asynchronous Communication Protocol 

Asynchronous data communication is the most widely used protocol, especially in applications 
where high data integrity is not mandatory. Data is transmitted, one character at a time, with 
each character being treated as an individual message. Start and stop bits are used to maintain 
timing coordination between the receiver and transmitter. A parity bit is sometimes included to 
detect character transmission errors. Asynchronous character format is as follows: Each charac- 
ter consists of a start bit, 5 to 8 data bits, an optional parity bit, and 1, 1.5, or 2 stop bits, with an 
optional time gap before the beginning of the next character. The total time from the beginning 
of one start bit to the beginning of the next is called a character frame. 

Parity options include: 

• NONE No parity bit is included. 

• ODD Parity set if EVEN number of "T's in character bits. 

• EVEN Parity set if ODD number of "l"s in character bits. 

• ONE Parity bit is set for all characters. 

• ZERO Parity bit is zero for all characters. 

Here is a simple diagram showing the structure of an asynchronous character and its rela- 
tionship to previous and succeeding characters: 



-hh- 



Preceding 
Character 



Line in 
Idle State 
(Mark) 



Start 
Bit 



10 

— Single Character Frame ■ 



Parity 
Bit 



Beginning of 
Character 



Stop 

Bit(s) 



End of 
Character 



Start Bit 
for Next 
Character 
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Data Link Communication Protocol 

Data Link protocol overcomes the data integrity limitations of Async by handling data in blocks. 
Each block is transmitted as a stream of individual asynchronous characters, but protocol 
control characters and block check characters are also transmitted with the data. The receiver 
uses the protocol control characters to determine block boundaries and data format. Block 
check charjicters are used to detect transmission errors. If an error occurs, the block is usually 
retransmitted until it is successfully received. Block protocol and format is similar to Binary 
Synchronous Communication (BSC or Bisync, for short). 

Data Link protocol provides for two transmission modes: transparent, and normal. In transpa- 
rent mode, any data format can be transferred because datacomm control characters are 
preceded by a DLE character. If a control character is sent without an accompanying DLE, it is 
treated as data. When normal mode is used, only ASCII data can be sent, and datacomm 
control characters are not allowed in the data stream. 



The HP 1000 and HP 3000 computers usually transmit in transparent mode. All transmissions 
from your desktop computer are sent as transparent data. If your application involves non- 
ASCII data transfers (discussed later in this chapter), be sure the HP 1000 or HP 3000 network 
host is using transparent mode for all transmissions to your computer. 

Each data block sent to the network host by the datacomm interface is structured as follows: 



-start ot Block 



sV 



End of Block - 



text (data) 



^V 



1 . The "start transmission" control characters identify the beginning of valid data. If a DLE is 
present, the data is transparent; If absent, data is normal. All data from your desktop compu- 
ter Is transparent. 

2. The terminal identification characters are included in blocks sent to the network host. Blocks 
received from the network host do not contain these two characters. 

3. Data characters are transmited in succession with no time lapse between characters. 

4. The "end transmission" control characters identify the end of data. DLE ETX or DLE ETB 
indicate transparent data. ETX or ETB indicates normal data. 

5. Block check characters (usually two characters) are used to verify data integrity. If the value 
received does not match the value calculated by the receiver, the entire block Is rejected by 
the receiver. Block check includes Group Identifier (GID) and Device Identifier (DID) charac- 
ters in transmissions to the network host. 

Protocol control characters are stripped from the data transfer, and are not passed from the 
interface to the computer. For information about network polling, terminal selection and other 
Data Link operations, consult the Data Link network manuals supplied with the HP 1000 or HP 
3000 network host computer. 
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Data Transfers Between Computer and Interface 

Data transfers between your desktop computer and its datacomm interface involve two mes- 
sage types: control blocks and data. Control blocks contain information sent to and received 
from the interface regarding its operation. Data is sent to and received from a remote device 
through the interface. Control blocks are not sent to or received from remote devices. Both 
types are encountered in both output and input operations as follows: 

• Outbound control blocks are created by CONTROL statements. 

• Outbound data messages are created by OUTPUT statements. 

• Inbound control blocks are created by certain protocol operations such as Data Link block 
boundaries, or Async prompt, end-of-line, parity/framing error, or break detection. 

• Inbound data messages are created by the interface as messages are received from the 
remote. They are transferred to BASIC by ENTER statements. 

Outbound Control Blocks 

Outbound control blocks are messages from your computer to the datacomm interface that 
contain interface control information. They are usually generated by CONTROL statements, 
although OUTPUT... END creates a control block that terminates a given Async transmission or 
forces a block to be sent on the Data Link. Outbound control blocks are serially queued with 
data, and executed by the interface in the same order as created by BASIC. The single excep- 
tion to the queued control block rule is when a non-zero value is output to Control Register 
(Interface Reset) which is executed immediately. 



Note 

When an interface card reset is executed by use of a CONTROL 
statement, the control block that results is transmitted directly to the 
interface. It is not queued up, so any previously queued data and 
control blocks are destroyed. To prevent loss of data, be sure that all 
queued messages have been sent before resetting the datacomm 
interface. Status Register 38 returns a value of 1 when the outbound 
queue is empty. Otherwise, its value is 0. To prevent loss of inbound 
data. Status Register 5 must return a value of zero prior to reset. 



Inbound Control Blocks 

Inbound control blocks are messages from the interface to the computer that identify protocol 
control information. Which item(s) are allowed to create a control block is determined by the 
contents of Control Register 14. Status Registers 9 and 10 identify the contents of the block, and 
Control Register 24 defines what protocol characters are also included with inbound Async data 
messages. Refer to the BASIC Language Reference Control and Status Register section for details 
about register contents for various control block types. 



The Datacomm Interface 269 



Two types of information are contained in each control block: type and mode. The type is 
contained in STATUS register 9; the mode in STATUS register 10. Type and Mode values can 
be used to interpret datacomm operation as follows: 

Async Protocol Control Blocks 



Type 


Mode 


Interpretation 


250 


1 


Break received (channel A). 


251 


1' 


Framing error in the following character. 


251 


2' 


Parity error in the following character. 


251 


3' 


Both Framing and Parity error in the following character 


252 


1 


End-of-line terminator detected. 


253 


1 


Prompt received from remote. 



Type 



254 
254 
253^ 



Mode 



Data Link Protocol Control Blocks 



Interpretation 



1 
2 



Preceding block terminated by ETB character. 
Preceding block terminated by ETX character. 
(See following table for Mode interpretation.) 



Mode Bit(s) 


Interpretation 





1 = Transparent data in following block. 




= Normal data in following block. 


2,1 


00 = Device Select (most common). 




01 = Group Select 




10 = Line Select 


3 


1 = Command Channel 




= Data Channel 



For Data Link applications, control blocks are normally set up for end-of-block (ETB or ETX). 
Control blocks are then used to terminate ENTER operations. Control block contents are not 
important for most applications unless you are doing sophisticated protocol-control program- 
ming. 

For Async applications, terminal emulator programs usually use prompt and end-of-line control 
blocks. Use of other functions such as break or error detection depend on the requirements of 
the individual application. 



1 Parity/framing error control blocks are not generated when characters with parity and/or framing errors are replaced by an underscore ( 1 
character. 



2 This type is used mainly in specialized applications. In most cases, you can expect a Mode value of zero or one for Type 253 Data Link control 
blocks. For most Data Link applications, control blocks are not used by programmers. 
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Outbound Data Messages 

Outbound data messages are created when an OUTPUT statement is executed. Here is a short 
summary of how OUTPUT parameters can affect datacomm operation. 

• Async protocol: Data is transmitted directly from the outbound queue. When operating in 
half-duplex, OUTPUT... END causes the interface to turn the line around and allow the 
remote device to send information back (line turn-around is initiated when the interface 
sets the Request-to-send line low). OUTPUT... END has no effect when operating in full 
duplex. 

• Data Link protocol: Data messages are concatenated until at least 512 characters are 
available, then a block of 512 characters is sent. Block boundaries may or may not 
coincide with the end of a given OUTPUT message. 

You can force transmission of shorter blocks by using the OUTPUT... END statement. The 
interface then transmits the last pending block regardless of its length. This technique is 
useful for ensuring that block boundaries coincide with message boundaries, or for send- 
ing one message string per block when you are transmitting short records. 

• Unless a semicolon or END appears at the end of a free-field OUTPUT statement, an EOL 
sequence is automatically sent at the end of the data. The EOL sequence is also suppres- 
sed by using the appropriate IMAGE specifier in an OUTPUT statement. See Chapter 4 for 
further information. 

Inbound Data Messages 

Inbound data messages are created by the datacomm interface as information is received from 
the remote. ENTER statements are terminated when a control block is encountered or the input 
variable is filled. Whether control characters are included in the data stream depends on the 
configuration of Control Register 24 (Async operation only). Control information is never 
included in inbound data messages when using Data Link protocol. 

With this brief introduction to the data communications capabilities of the HP 98628 Data- 
comm Interface, you are ready to begin programming your desktop computer for datacomm 
operation. The next section of this chapter introduces BASIC datacomm programming techni- 
ques using simple terminal emulator examples that can be readily expanded into much more 
sophisticated datacomm programs. 
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Overview of Datacomm Programming 

Your desktop computer uses four BASIC statements for data communication with remote 
computers, terminals, and other peripheral devices. Datacomm programs include part or all of 
the following elements: 

• CONTROL statements to configure the datacomm link and establish the connection. 

• OUTPUT and ENTER statements to transfer information. 

• STATUS statements to monitor operation. 

• CONTROL statements to alter link parameters during the session, if needed for unusual 
applications. 

• OUTPUT and ENTER statements to transfer additional information. 

• A CONTROL statement to disconnect at the end of the session. 

Here is a simple example of an Async terminal emulator that uses default parameters. The user 
must disconnect at the end of a session by executing the command CONTROL Sc»12IO from 
the keyboard. 



DatacoMM on Select Code 27. 
Set Control Block MasK. 
Dataoomw interface uses defaults 
and automatically connects to line. 
Up to 700 characters per line. 
Get Rx lueue status. 



Get data from queue. 

Print data. 

Get Control Block TYPE field. 



1000 Sc=27 

1010 CONTROL Sc .1^56 

1020 OUTPUT Sc;CHR*(13); 

1025 

1030 Check_reader:DIM A*[700] 

1040 STATUS Sc .5iRx_avail_bits 

1050 IF Rx_ayail_bits>l THEN 

lOBO ENTER Sc USING "«»K";A* 

1070 PRINT USING "«»»K" 5A* 

1080 STATUS Sc .SJR 

1090 IF R=253 THEN 

1100 LINPUT "Enter line to send to remote. 'SA* 

1110 OUTPUT Sc;A*;CHR*< 13) i 

1120 END IF 

1130 END IF 

1140 GOTO Check-reader 

1150 END 

While this program shows the relative simplicity of using your computer for data communica- 
tion, most applications require more sophisticated techniques. The following pages show more 
elaborate structures to illustrate some of the concepts used in creating programs for datacomm 
applications. 

Two sample terminal emulator programs, one for Async and one for Data Link, are used in this 
chapter to show you how to write datacomm programs with a minimum of difficulty and 
complexity^. Both versions are very similar; differences are explained fully. The emulators are 
explained in logical sequence, with complete program listings included at the end. The exam- 
ples can be used as written, or expanded to include other features. They are designed to 
demonstrate program structures and programming techniques that are used in many data 
communication applications. 
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Establishing the Connection 

Determining Protocol and Link Operating Parameters 

Before information can be successfully transferred between two devices, a communication link 
must be established. You must include the necessary protocol parameters to ensure compatibil- 
ity between the communicating machines. To determine the proper parameters for your ap- 
plication, select Async or Data Link protocol, then answer the following questions: 

For BOTH Async and Data Link Operation: 

• Is a modem connection being used? What handshake provisions are required? (Data Link 
does not use modems, but multi-point Async modem connections use a protocol compati- 
ble with Data Link. ) 

• Is half-duplex or full-duplex line protocol being used? 

For Async Operation ONLY: 

• What line speed (baud rate) is being used for transmitting? 

• What line speed is being used for receiving? 

• How many bits (excluding start, stop, and parity bits) are included in each character? 

• What parity is being used: none, odd, even, always zero, or always one? 

• How many stop bits are required on each character you transmit? 

• What line terminator should you use on each outgoing line? 

• How much time gap is required between characters (usually 0)? 

• What prompt, if any, is received from the remote device when it is ready for more data? 

• What line terminator, if any, is sent at the end of each incoming line? 

For Data Link Operation ONLY: 

• What line speed (baud rate) is being used? (Data Link uses the same speed in both 
directions. ) 

• What parity is being used: none (HP 1000 network host), or odd (HP 3000 network 
host)? 

• What is the device Group IDentifier (GID) and Device IDentifier (DID) for your terminal? 

• What is the maximum block length (in bytes) the network host can accept from your 
terminal? 

All these parameters are configured under program control by use of CONTROL statements. 
Alternately, default values for line speed, modem handshake, parity, and Async or Data Link 
protocol selection can be set using the datacomm interface configuration switches. Other de- 
fault parameters are preset by the datacomm interface to accommodate common configura- 
tions. You can use the defaults, or you can override them with CONTROL statements for 
program clarity and immunity to card settings. Default Control Register values are shown in the 
"Interface Register" section in the back of the BASIC Language Reference manual. The HP 
98628 Datacomm Interface Installation manual explains how to set the default switches on the 
interface. 
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The next section of this chapter shows a summary of the available default options and switch 
settings for both Async and Data Link. 

Using Defaults to Simplify Programming 

The datacomm interface includes two switch clusters. One cluster is used to program the select 
code and interrupt level (hardware priority). The other cluster sets defaults for protocol, line 
speed (baud rate), modem handshake, and parity. Setting the defaults on the card eliminates 
the need to program the corresponding interface CONTROL registers. These defaults are useful 
in applications where the configuration of the link is rarely altered, and the program is not used 
on other machines with dissimilar configurations. They also enable a beginning programmer to 
use OUTPUT and ENTER statements to perform simple datacomm operations without using 
CONTROL or STATUS statements. On the other hand, where link configuratiion may vary, or 
where programs are used on several different machines with dissimilar configurations, it is 
usually worthwhile to override the defaults with CONTROL statements as described in the 
programming examples. This assures known datacomm behavior, independent of interface 
defaults. 

Here, for your convenience is a brief summary of the default switch options: 




Parity 


Bits/Char 


00 = None 


8 


01 =None 


7 


10 = Odd 


7 


1 1 = Even 


7 



Hardware Handshake 

00 = Handshake OFF, 
non-modem connection' 

01 = FULL Duplex modem 

connection^ 
1 = HALF Duplex modem 

connection^ 
11 = Handshake ON, 

non-modem connection' 



Baud Rate Stop Bits 



000 = 110 
001=150 
010 = 300 
011=600 
100 = 1200 
101=2400 
110 = 4800 
111=9600 



2 
2 



Async Default Configuration Switches 

' Default No Activity timeout: Disabled 
^ Default No Activity timeout: 1 minutes 
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DID: {"(a)' 


. . ."G") 


000 = @ 


100 = D 


001 = A 


101 = E 


010 = B 


110 = F 


011=C 


111 = G 



Baud Rate 

00 == 300 

01 == 1200 
10 = 9600 

11-19200 



Hardware Handshake 

00 = Handshake OFF, non-modem connection 

01 = FULL Duplex modem connection 

10 = HALF Duplex modem connection 

11 = Handshake ON, non-modem connection 



Default GID = "A" 



Default No Activity timeout: 10 minutes 



Data Link Default Configuration Switches 

Resetting the Datacomm Interface 

Before you establish a connection, the datacomm interface must be in a known state. The 
datacomm interface does not automatically disconnect from the datacomm link when the 
computer reaches the end of a program. To prevent potential problems caused by unknown 
link conditions left over from a previous session, it is a good practice to reset the interface card 
at the beginning of your program before you start configuring the datacomm connection. 
Resetting the card causes it to disconnect from the line and return to a known set of initial 
conditions. 

In the following example, a numeric variable is used to define the select code. The second 
statement resets the card after the select code has been defined. 



1110 
IIBO 



Sc = ZO 
CONTROL Sc 



o;i 



! Set select code to 20. 

! Reset the card to disco nnect from line. 



Protocol Selection 

During power-up and reset, the card uses the default switches to preset the card to a known 
state. The protocol select switch defines which protocol the card uses at power-up only. If the 
default protocol is the same as you are using, you can skip the protocol selection statements. 
However, if the switch might be set to the wrong protocol, or if you want to change protocol in 
the middle of a program, you can use a CONTROL statement to select the protocol. After the 
protocol is selected, reset the card again to make the change. Here is how to do it: 
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Select the protocol to be used: 

1170 CONTROL Sc»3;i ! Select As/nc Protocol 

or 

1170 CONTROL Sc»3i2 ! Select Data LinK Protocol 

Wait until the protocol select message has been sent to the card, (lines 1180-1200) then reset 
the card. The Reset command restarts the interface microcomputer using the selected protocol. 

1180 WaitrSTATUB Sc >38 > Al l_s en t ! Get transmit queue status. 
1190 IF NOT All-sent THEN Wait ! If not donet wait. 
1200 CONTROL Sc»0;i ! Reset interface card. 

Note 

Be careful when resetting the interface card during normal program 
operation. Data and Control information are sent to the card in the 
same sequence as the statements originating the information are 
executed. When a card reset is initiated by a CONTROL statement, 
the reset is not placed in the queue with outbound data, but is 
executed immediately. Therefore, if there is other information in the 
output queue waiting to be sent, a reset can cause the data to be lost. 
To prevent loss of data, use STATUS statements (register 38) to 
verify that all data transfers have run to completion before you reset 
the interface. 

You are now ready to program datacomm options that are related to the selected protocol. In 
applications where defaults are used, the options are very simple. The following pair of exam- 
ples shows how to set up datacomm options for each protocol. 

Datacomm Options for Async Communication 

This section explains how to configure the datacomm interface for asynchronous data com- 
munication. The example used shows how to set up all configurable options without consider- 
ing default values. Some statements in the example are redundant because they override 
interface defaults having the same value. Others may or may not be redundant because they 
override configuration switch options. The remaining statements are necessary because they 
override the default values, replacing them with non-default values required for proper opera- 
tion of the example program. If you are not familiar with Asynchronous protocol, consult the 
section on protocol for the needed background information. 
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The following program lines set up all the CONTROL register options (a 300-baud connection 
to an HP 1000 is assumed): 



1250 
12G0 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
13^0 
1350 
13B0 
1370 
1380 
1390 
lilOO 
1410 
1420 
1430 
1440 
1450 



CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 



Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 



CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 



14 
15 
IB 
17 
18 
19 
20 
21 
22 
23 
24 

2G 
27 
28 
31 
34 
35 
3G 
37 
39 



3 







40 

10 

7 

7 

1 
GG 

G 

5 

2 , 1 3 » 1 

1 »17 

*? 


1 

4 



Set control 
No modem li 
Infinite co 
Disable No 
Lost Carrie 
Transmit t i 
Transmit sp 
Receiue spe 
EQ/AK (as t 
Full Duplex 
Remote p r o t 
EOL. Chan 
AssiSn AK o 
Assign EO c 
Set EOL seq 
Set prompt 
S e v e n bits 
One stop b i 
Odd parity. 
No inter-ch 
Set BREAK t 



block mask for EOL & Prompt 
ne-chanSe notification, 
nnection timeout. 
Activity timeout, 
r 400 ms. * 
me out 10 s. 
eed = 300 baud, 
ed = 300 baud, 
erminal) handshake. 

connection, 
ocol characters except 
Se errors to Underscore, 
haracter for EO/AK. 
haracte r for EO/AK . 
u e n c e to be CR-LF. 
to be DCl . (33 not used ) . 
per character, 
t . 

aracter time Sap. 

four character times. 



♦ : Redundant statement. Same as interface default. 

-»: May be redundant. Overrides configuration switch option. 



Refer to the Control Register tables in the back of the BASIC Language Reference manual as 
you examine the CONTROL statements. The paragraphs which follow explain register func- 
tions and how to configure them. 

Control Block Contents 

Configuration of the link begins with register 14 which determines what information is placed in 
the control blocks that appear in the input (receive) queue. In this example, only the end-of-line 
position and prompts are identified. Parity or framing errors in received data, and received 
breaks are not identified in the queue. This register interacts with Control registers 28 thru 33. 

Modem-initiated ON INTR Branching Conditions 

Register 15 is rarely used in most applications because the interface usually manages all interac- 
tion with the modem. Modem interrupts are helpful when you are simulating your own line 
protocol. This register determines what changes in one or more modem lines can cause a 
program branch to occur when an ON INTR statement is active for that select code. Values from 
thru 31 can be used, where a "1" in a bit position enables branching whenever the corres- 
ponding signal line changes state. Lines correspond to bits thru 4 of STATUS register 7. In 
this example, modem functions are handled by the interface; no interaction with BASIC is 
necessary. If this register is given a non-zero value, bit 3 of the ENABLE INTR mask should be 
set. (ENABLE INTR statement is line 1820 of the example terminal emulator program.) 
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Datacomin Line Timeouts 

Registers 16-19 set timeout values to force an automatic disconnect from the datacomm link 
when certain time limits are exceeded. For most applications, the default values are adequate. 
A value of zero disables the timeout for any register where it is used. Each register accepts 
values of thru 255; units vary with the register function. 

• Register 16 (Connection timeout) sets the time limit (in seconds) allowed for connecting to 
the remote device. It is useful for aborting unsuccessful attempts to dial up a remote 
computer using public telephone networks. 

• Register 17 (No Activity timeout) sets an automatic disconnect caused by no datacomm 
activity for the specified number of minutes. Default value is determined by default hand- 
shake switch setting. Default is not affected by CONTROL statements to Control Register 
23 (hardware handshake). 

• Register 18 (Lost Carrier timeout) disconnects when: 

F'uli Duplex: Data Set Ready (Data Mode) or Data Carrier Detect go false, or 
Half Duplex: Data Set Ready goes false, 

indicating that the carrier from the remote modem has disappeared from the line. 
V/alue is in multiples of 10 milliseconds. 

• Register 19 (Transmit timeout) disconnects when a loss-of-clock occurs or a clear-to-send 
(CTS) is not returned by the modem within the specified number of seconds. 

Line Speed (Baud Rate) 

The transmit and receive line speed(s) are set by Control Registers 20 and 21, respectively. 
Each is independent of the other, and they are not required to have identical values. The 
following baud rates are available for Async communication: 



Register 


Baud 


Register 


Baud 


Register 


Baud 


Register 


Baud 


Value 


Rate 


Value 


Rate 


Value 


Rate 


Value 


Rate 





0' 


4 


134.5 


8 


600= 


12 


3600 


1 


50 


5 


150=^ 


9 


1200^ 


13 


4800^ 


2 


75 


6 


"200 


10 


1800 


14 


9600^ 


3 


110^ 


7 


300^ 


11 


2400^ 


15 


19 200 



1 An external clock must be provided for this option. 

2 These speeds can be programmed using the default switches on the interface card. Other speeds are accessed by CONTROL statements. (The 
HP 13265A Modem can be operated up to 300 baud.) 



All configurable line speeds are available to CONTROL Registers 20 and 21. Only the eight 
speeds indicated can be selected using the default switches (see the switch configuration dia- 
gram earlier in this chapter). When the configuration switch defaults are used, transmit and 
receive speeds are identical. The selected line speed must not exceed the capabilities of the 
modem or link. 
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Handshake 

Registers 22 and 23 configure handshake parameters. There are two types of handshake: 

• Software or protocol handshake specifies which of the participants is allowed to transmit 
while the other agrees to receive until the exchange is reversed. Options include: 

1. No handshake, commonly used with connections to non-interactive devices 
such as printers. 

2. Enq/Ack (EQ/AK) or DC1/DC3 handshake, with the desktop computer confi- 
gured either as a host or a terminal. Handshake characters are defined by regis- 
ters 26 and 27. 

3. DC1/DC3 handshake with the desktop computer as both a host AND a termin- 
al. Handshake characters are defined by registers 26 and 27. This option simpli- 
fies communication between two desktop computers. 

• Hardware or modem handshake that establishes the communicating relationship be- 
tween the interface and the associated datacomm hardware such as a modem or other link 
device. The four available options are: 

1. Handshake Off, non-modem connection - most commonly used for 3-wire 
direct connections to a remote device. 

2. Full Duplex modem connection — used with full-duplex modems or equivalent 
connections. 

3. Half Duplex modem connection - used with half-duplex modems or equiva- 
lent connections. 

4. Handshake On, non-modem connection - used with printers and other similar 
devices that use the Data Carrier Detect (DCD) and Clear-to-send (CTS) lines to 
signal the interface card. When DCD is held down by the peripheral, the inter- 
face ignores incoming data. When CTS is held down, the interface does not 
transmit data to the device until CTS is raised. 

Options 2 and 3 are usually associated with modems or similar devices, but may be used 
occasionally with direct connections when the remote device provides the proper signals. Refer 
to the table at the end of this chapter for a list of handshake signals and how they are handled 
for each cable or adapter option. 

Handling of Non-data Characters 

Register 24 specifies what non-data characters are to be included in the input queue. For each 
bit that is set, the corresponding information is passed along with the incoming data. If the bit is 
not set, the information is discarded, and is not included in the inbound data stream that is 
passed to the desktop computer by the interface. 
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Bit 0: Include handshake characters in data stream. They are defined by Control Registers 
26 and 27. 

Bit 1: Include incoming end-of-line character(s). EOL characters are defined by Control 
Registers 28-30. 

Bit 2: Include incoming prompt character(s). Prompt is defined by Control Registers 31- 
33. 

Bit 3: Include any null characters encountered. 

Bit 4: Include any DEL (rubout) characters in data. 

Bit 5: Include any CHR$(255) encountered. This character is encountered ONLY when 
8-bit characters are received. 

Bit 6: Change any characters received with parity or framing errors to an underscore. If 
this bit is not set, all inbound characters are transferred exactly as received, with or 
without errors. 

Register 25 is not used. 

Protocol Handshake Character Assignment 

Registers 26 and 27 establish what characters are to be used for handshaking between com- 
municating machines. You can select the values of 6 (AK) or 17 (DCl) for register 26, and 5 
(EQ) or 19 (DCS) for register 27. Any ASCII value from thru 255 can be used, but non- 
standard values should be reserved for exceptional situations. 

End-of-line Recognition 

Registers 28, 29, and 30 operate in conjunction with registers 14 (control block mask) and 24 
(non-data character stripping) and defines the end-of-line sequence used to identify boundaries 
between incoming records. Register 28 (value of 0, 1 or 2) defines the number of characters in 
the sequence, while registers 29 and 30 contain the decimal equivalent of the ASCII characters. 
If register 28 is set for one character, register 30 is not used. Register 29 contains the first EOL 
character, and register 30, if used, contains the second. If register 28 is zero, registers 29 and 30 
are ignored and the interface cannot recognize line separators. 

Prompt Recognition 

Registers 31, 32, and 33 operate in conjunction with registers 14 and 24 and define the prompt 
sequence that identifies a request for data by the remote device. As with end-of-line recogni- 
tion, the first register defines the number of characters (0, 1, or 2), while the second and third 
registers contain the decimal equivalents of the prompt character(s). Register 33 is not used 
with single-character prompts. If register 31 is zero, registers 32 and 33 are ignored and the 
interface is unable to recognize any incoming prompts. 
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Character Format Definition 

Registers 34 through 37 are used to define the character format for transmitted and incoming 
data. 

• Register 34 sets the character length to 5, 6, 7, or 8 bits. The value used is the number of 
bits per character minus five (0==5 bits, 3 = 8 bits). When 8-bit format is specified, parity 
must be Odd, Even, or None (parity "1" or "0" cannot be used). 

• Register 35 specifies the number of stop bits sent with each character. Values of 0, 1, or 2 
are used to select 1, 1.5, or 2 stop bits, respectively. 

• Register 36 specifies the parity to be used. Options include: 



Register 
Value 


Parity 


Result 





None 


Characters are sent with no parity bit. No parity checks are made on 
incoming data. 


1 


Odd' 


Parity bit is set if there is an EVEN number of ones in the character 
code. Incoming characters are also checked for odd parity. 


2 


Even' 


Parity bit is set if there is an ODD number of ones in the character 
code. 


3 





Parity bit is present, but always zero. No parity checks are made on 
incoming data. 


4 


1 


Parity bit is present, but always one. No parity checks are made on 
incoming data. 



Parity must be odd, even, or none when 8-bit characters are being transferred. 



• Register 37 sets the time gap (in character times, including start, stop, and parity bits) 
between one character and the next in a transmission. It is usually included to allow a 
peripheral, such as a teleprinter, to recover at the end of each character and get ready for 
the next one. A value of zero causes the start bit of a new character to immediately follow 
the last stop bit of the preceding character. 

Control Register 38 is not used. 

Break Timing 

Register 39 sets the break time (2-255 character times). A Break is a time gap sent to the remote 
device to signify a change in operating conditions. It is commonly used for various interrupt 
functions. The interface does not accept values less than 2. Register 6 is used to transmit a 
break to the remote computer or device. 



1 Parity sense is based on the number of ones in the character including the parity bit. An EVEN number of ones in the character, plus the parity 
bit set produces an ODD parity. An ODD number of ones in the character plus the parity bit set produces an EVEN parity. 
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Datacomm Options for Data Link Communication 

This section explains how to configure the datacomm interface for Data Link operation. The 
example used shows how to set up configuration options without considering default values. 
Some statements in the example are redundant because they override interface defaults having 
the same value. Others may or may not be redundant because they override configuration 
switch options. The remaining statements are necessary because they override the default 
values, replacing them with non-default values required for proper operation of the example 
program. If you are not familiar with Data Link protocol and terminology, consult the section 
called "Protocol." 

The following program lines set up all the CONTROL register options (a 9600-baud connection 
to an HP 1000 network host is assumed): 



1250 
1260 
1270 
1280 
1290 
1300 
1310 
1320 
1330 
13^0 
1350 
1360 



CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 



Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 
Sc 



ia;6 

15 iO 

16 ;o 

17 ;o 



18! 
19! 



40 
10 

2o;i4 

21 il 

22 il 

23;o 

24 iO 

36 ;o 



Set Coritrol BlocK MasK for ETB/ETX. 

No Modem line-chanSe notification. 

Disable Connection timeout. 

Disable' No Activity timeout. 

Set Lost Carrier to 400 ms. 

Set Transmit Timeout=10 s. 

Set Line Speed to 3600 baud. 

Set GID character to "A". 

Set DID character to "A". 

Hardware Handshake Off for HP 13264A, 

Set transmit blocK size to 512. 

Parity not used with HP 1000. 



* : Redundant statement. Same as interface default. 

■*: May be redundant. Overrides configuration switch option. 

If your application requires a different GID/DID pair, you can use either of the following two 
techniques (assume: GID = "C" and DID-"@"): 



1320 CONTROL Sc t21 ,3 
1330 CONTROL Sc .22 50 



! Set GID character to "C". 
! Set DID character to "i". 



or 



1320 CONTROL So .21 53 >0 ! Set GID/DID to "C@". 

(Line 1330 is not needed in this case.) 
Here is an alternative method using string operations: 



or 



1320 CONTROL Sc .2 1 i NUM ( "C " ) -64 
1330 CONTROL Sc .22 5NUM ( " @" ) -84 

1320 CONTROL Sc .21 JNUM ( "C " ) -64 .NUM ( " @" ) -64 



Refer to the Control Register tables in the back of the BASIC Language Reference manual as 
you examine the CONTROL statements. The paragraphs which follow explain register func- 
tions and how to configure them. When the register function is identical for both Async and 
Data Link, you are referred to the previous explanation in the Async section. 
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Control Block Contents 

Data Link configuration begins with Control Register 14. This register determines what informa- 
tion is to be placed in control blocks and included with inbound data transferred from the 
interface to the desktop computer. 

• ETX (Bit 1) identifies the end of a transmission block that contains one or more complete 
records. 

• ETB (Bit 2) identifies the end of a transmission block where the last record is continued in 
the next block of data. 

• Bit causes a control block to be inserted that identifies the beginning of a new block of 
data. 

ON INTR Branching Conditions, 

Datacomm Line Timeouts, and Line Speed 

Registers 15 through 19 are functionally identical for both Async and Data Link. Refer to the 
preceding Async section for more information. Register 20 sets the line speed for both transmit- 
ting and receiving (Data Link does not accommodate split-speed operation). The following line 
speed options are available: 



Register 
Value 


Baud 
Rate 


Register 
Value 


Baud 
Rate 


Register 
Value 


Baud 
Rate 


Register 
Value 


Baud 
Rate 



7 
8 


External Clock' 
300^ 
600 


9 
10 
11 


1200^ 
1800 
2400 


12 
13 
14 


3600 
4800 
9600^ 


15 


19 200^ 



Terminal Identification 

Registers 21 and 22 specify the terminal identifier characters for the datacomm interface. 
Register 21 contains the GID (Group IDentifier), and register 22 contains the DID (Device 
IDentifier. Values of 0-26 correspond to the characters @, A, B, . . ., Z. These registers must be 
configured to match the terminal identification pair assigned to your device by the Data Link 
Network Manager. In the example, Line 1320 is redundant because it duplicates the default 
GID value. Line 1330 overrides the DID default switch on the interface card, and may or may 
not be necessary. Alternate methods for assigning different GID/DIDs are shown following the 
group of configuration CONTROL statements. 

Handshake 

Register 23 establishes the hardware handshake type. There is no formal software handshake 
with Data Link because the network host controls all data transfers. Hardware or modem 
handshake options are identical to Asynchronous operation. Handshake should be OFF (regis- 
ter set to 0) when using the HP 13264A Data Link Adapter. When you are using non-standard 
interconnections such as direct or modem links to the network host, select the handshake 
option that fits your application. Refer to the table at the end of this chapter for a list of 
handshake signals and how they are handled for each cable or adapter option. 



1 An external clock must be provided for this option. 

2 These speeds can be programmed using the default switches on the interface card. Other speeds are accessed by CONTROL statements. 
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Transmitted Block Size 

Register 24 defines the maximum transmitted block length. When transmitting blocks of data to 
the network host, the block length must not exceed the available buffer space on the receiving 
device. Block size can be specified for increments of two from 2 to 512 characters per block. A 
value of zero forces the block length to a maximum of 512 bytes. For other values, the block 
length limit is twice the value sent to the register. For example, a register value of 130 produces 
a transmitted block length not exceeding 260 characters (bytes). 

Parity 

Register 36 defines the parity to be used. Unlike Async, Data Link has only two parity options: 
None, or Odd. Odd parity is: 



Register 
Value 


Parity 


Application 




1 


NONE 
ODD 


Required for operation with HP 1000 network host 
Required for operation with HP 3000 network host 



Registers 25 through 35, and 37 and above are not used. 

Connecting to the Line 

Interface configuration is now complete. You are ready to begin connecting to the datacomm 
line. The exact procedure used to connect to the line varies slightly, depending on the type of 
link being used. Before you connect, you must know what the link requirements are, including 
dialing procedures, if any. 

Switched (Public) Telephone Links 

When you are using a public or switched telecommunications link, the modem connection 
between computers must be established. The HP 13265A Modem can be used in any Async 
application that requires a Bell 103- or Bell 113-compatible modem operating at up to 300 
baud line speed. However, the HP 13265A Modem is not suitable for data rates exceeding 300 
baud. For higher baud rates, use a modem that is compatible with the one at the remote 
computer site. Modems cannot be used for remote connections from a terminal to the data link. 

Private Telecommunications Links 

Private (leased) links require modems unless the link is short enough for direct connection (up 
to 50 feet, depending on line speed). The HP 13265A Modem can be used at data rates up to 
300 baud. For higher speeds, a different modem must be used. 

Direct Connection Links 

For short distances, a direct connection may be used without modems or adapters, provided 
both machines use compatible interfaces. Async connections normally use RS-232C interfaces. 
You can also operate as a Data Link terminal directly connected to an HP 1000 or HP 3000 
host computer through a dedicated Multipoint Async interface on the network host, although 
such connections are unusual. 
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Data Link Connections 

Most Data Link connections use an HP 13264A Data Link Adapter to connect directly to the 
Data Link. In special situations, a modem may be used to communicate with a Multipoint Async 
interface on the HP 1000 or HP 3000 network host. When the Data Link Adapter is used, no 
special procedures are required. If you are usiog a leased or switched telecommunications link, 
the procedures are the same as when using point-to-point Async with modems. 

Connection Procedure 

This section describes procedures for modem connections using telephone telecommunications 
circuits. If you are NOT using a switched, modem link, skip to the next section: Initiating the 
Connection. 

Dialing Procedure for Switched (Public) Modem Links 

Except for dialing, connection procedures do not usually vary between switched and dedicated 
links. Dialing procedures depend on whether the modem is designed for manual or automatic 
dialing. Automatic dialing can be used with the HP 13265A Modem, but other modems must be 
operated with manual dialing unless you design your own interface to an Automatic Calling 
Unit. For manual dialing procedures, consult the operating manual for the modem you are 
using. 

Automatic Dialing with the HP 13265A Modem: 

The automatic dialer in the HP 13265A Modem is accessed by Control Register 12. The 
CONTROL statement is followed by an OUTPUT statement that contains the telephone num- 
ber string, including dial rate and timing characters. The two statements set up the automatic 
dialer, but dialing is not started until a "start connection" command is sent to Control Register 
12. Here is an example sequence: 

1500 CONTROL Sc.l2;2 ! Enable the Automatic Dialer. 

1510 OUTPUT Sc;"> g nee (303)7555-123^"; 



Li (yn 



recognized characters are ignored. 

3-second wait for secondary dial tone. 

-Select FAST dial rate. 



The OUTPUT statement contains several essential elements. 

• The first character (">"). if included, specifies a fast dialing rate. If it is omitted, the default 
slow dialing rate is used. 

• A time delay character "@" may be inserted anywhere in the string. A one-second time 
delay is executed in the dialing sequence each time a delay character is encountered. 

• Numeric character sequences define the telephone number. Multiple dial-tone sequences, 
such as when calling out from a PBX (Private Branch Exchange), can be used by inserting 
a suitable delay to wait for the next dial tone. 

• Unrecognized characters such as parentheses, hyphens, and spaces can be included for 
clarity. They are ignored by the automatic dialer. 

• Up to 500 characters can be included in the telephone number string. 
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Here is how an autodial connection is executed: 

• The CONTROL Sc»12;2 statement places a "start dialing" control block in the out- 
bound queue to the interface. The OUTPUT statement places the telephone number string 
(including spaces and other characters) in the queue after the control block. When the 
interface encounters the control block, it transfers the string to the HP 13265A Modem's 
autodial circuit. No other action is taken at this time. 

• When a CONTROL Sc»i2;i statement (line 1600 in the example) is executed, another 
control block is queued up. When the interface encounters the block, it sends a "start 
connection" command to the modem. The modem then disconnects from the line, waits 
two seconds, then reconnects. The autodialer waits 500 milliseconds, then starts executing 
the telephone number string. The string is executed character-by-character in the same 
sequence as sent by the OUTPUT statement. 

• If your application requires more than 500 milliseconds to guarantee a dial tone is present, 
you can increase the delay by adding delay characters ("@") where needed, one second 
per character. Be sure to provide adequate delays in multiple dial tone sequences, such as 
when calling through a private branch exchange (PBX) to a public telephone network. 

• When dialing is complete, the modem is connected to the line, and you are ready to start 
communication. The next section explains how to determine when connection is com- 
plete. 

Two dialing rates are available: slow (default) and fast. To select the fast rate, you must include 
the fast rate character (">") as the FIRST character in the telephone number string. Here is a 
summary of differences between the two options: 



Parameter 



Click Length 
Click Gap 
Number Gap 



Slow Dialing 



60 milliseconds 

40 milliseconds 

700 milliseconds 



Fast Dialing 



32.5 milliseconds 
17.5 milliseconds 
300 milliseconds 



One to ten dial pulses (clicks) are sent for each digit 1 through 0, respectively. The number gap 
is the time lag between the end of the last click of one number and the beginning of the first click 
of the next number. 

Most Bell System facilities can handle both fast and slow dialing rates, but private or indepen- 
dent telephone systems or companies may require slow dialing. 

Initiating the Connection 

After you have executed the necessary dialing procedures, if any, you are ready to initiate the 
connection. The following statement is used to start the connection: 

IGOO CONTROL Sc.l2;i ! Start Connection, 

This statement sends a control block to the interface telling it to connect to the datacomm line. If 
the HP 13265A Modem is being used, and the autodialer is enabled, it starts dialing the 
number. Otherwise, the interface executes a direct connection to the line, or tells the modem or 
data link adapter to connect. 
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The status of the connection process can be monitored by using the STATUS statement. The 
following lines hold the computer in a continuous loop until the connection is complete: 

1B50 Conn:STATLJS Sc » 1 2 ! L in e_5 t at e ! Get datacomm line status. 

1B60 IF Line_state=Z THEN DISP "DialinS" 

1B70 IF Line_state = l THEN DISP "Try in 3 to Connect" 

1G80 IF Line_5tate<>3 THEN Conn 

1890 DISP "Connected" 

Refer to the "Interface Registers" section of the BASIC Language Reference for interpretation 
of the values in Status Register 12. Only values of 1, 2, or 3 are usually encountered at this 
stage of the program. 

As soon as Status Register 12 indicates that connection is complete, you are ready to continue 
into the main body of the terminal emulator or other program you are writing. This completes 
the datacomm initialization and connection phase of the program. 



Setting up the Interrupt System 

Most datacomm programs, especially complex ones, use interrupt branching extensively to 
maintain efficient, orderly program operation. Branching is usually set up for: 

• I/O interrupts from peripheral devices by use of ON INTR and ENABLE INTR statements. 

• Datacomm interrupts from the datacomm interface. Statements used are the same as for 
other I/O interrupts. 

• Operator interrupts using softkeys for program control. A separate ON KEY statement is 
used to set up the branch for each key used. 

• Operator interrupts using ASCII keys for program input. The ON KBD statement is used to 
set up the branch, and KBD$ is the keyboard-entry string holding the data. 

Each interrupt branch must be provided with a corresponding interrupt service routine, with 
priority levels assigned when appropriate. General I/O interrupt techniques are explained in 
Chapter 7. This section explains the interrupt structures commonly encountered in datacomm 
applications. 

Setting up Softkey Interrupts 

Softkeys are usually set up for repetitively executed functions to improve operator convenience 
and efficiency. Labels can have up to eight or 14 characters for each key, depending on CRT 
screen width. The following statements add a disconnect and break capability to the emulator 
example we are using: 

1750 ON KEY LABEL " Disconn" GOTO Disconnect 
17B0 ON KEY 1 LABEL " Break" GDSUB Break 

Other keys can be set up and labelled as needed, but remember a service routine is required for 
each label specified by a GOTO, GOSUB, CALL, or RECOVER. 
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Setting Up Program Operator Inputs 

Two methods are commonly used to input information from the operator through the computer 
keyboard. The first method uses the LINPUT (or INPUT) statement for data entry. An example 
program using the LINPUT statement is shown in the overview of datacomm programming 
eariier in this chapter. When the LINPUT statement requests a data entry, type the information, 
use the keyboard editor to make any necessary corrections, then press CONTINUE to transfer 
the informeition to the running program. This is the simplest method for programming keyboard 
entry. The second method is used in our ongoing example. It uses the ON KBD statement in 
conjunction with an interrupt service routine that is responsible for all data manipulation, 
including display, editing, and transfer to the program. The following statement sets up the 
keyboard interrupt. The interrupt service routine is discussed later. 

1770 ON KBD GOSUB Keyboard 

Setting Up Datacomm Interrupts 

The ON INTR and ENABLE INTR statements are used to set up program branching for the 
datacomm interface. STATUS Register 4 contains information that shows the cause(s) of the 
most recent interrupt. The interrupt mask specified in the ENABLE INTR statement determines 
the events that are allowed to cause an interrupt branch. Bits thru 5 of the interrupt mask and 
STATUS register are identical for both Async and Data Link protocols. Bits 6 and 7 are used for 
Async only. 

The following statements set up the interrupt structure for datacomm: 



1810 ON INTR Sc GOSUB 
1820 ENABLE INTR Sc il 



Dat aooMM 



! Interrupt when data receiue< 



In more elaborate applications, you may want to enable additional interrupt causes by changing 
the interrupt mask. Here are the available interrupt bits and their functions: 

Interrupt Mask Bits for Async Operation 



Bit 


Value 


Function 



1 
2 
3 


1 
2 

4 
8 


Data in Receive Queue 
Prompt Received 
Framing/Parity Error 
Modem Line Change 



Bit 


Value 


Function 


4 
5 
6 
7 


16 
32 

64 
128 


No Activity Timeout 
Lost Carrier Timeout 
End-of-line Received 
Break Received 



Interrupt Mask Bits for Data Link Operation 



Bit 


Value 


Function 



1 
2 


1 
2 
4 


Data in Receive Queue 
Block Successfully Sent 
Transmit or Receive Error 



Bit 


Value 


Function 


3 
4 
5 


8 

16 

32 


Modem Line Change 
No Activity Timeout 
Lost Carrier Timeout 



Interrupt mask bits 6 and 7 are not used with Data Link protocol. 
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To construct the interrupt mask value, add the bit values for each function that is to cause an 
interrupt. For example, to interrupt when there is data in the receive queue (bit value = 1), or a 
modem line change (bit value = 8) or a Lost Carrier timeout (bit value = 32). the interrupt mask 
becomes: 1 + 8 + 32 = 41. The ENABLE INTR statement becomes: 

1820 ENABLE INTR Sciai 



Background Program Routines 

After the interrupt structures have been established by the running program, the program 
begins executing a "background" routine while it waits for interrupts. Background routines 
vary according to application, and can consist of anything from a simple idle loop to a very 
complex program. They are called background programs or background routines because their 
execution is generally suspended whenever interrupts from previously defined sources are 
received. See Chapter 7 for more discussion of interrupt and software priority. 

Background program operations can affect interrupt handling under certain conditions. For 
example, if the background program contains a subprogram call, the interrupt service routines 
are temporarily suspended until subprogram execution is complete if the ON INTR statements 
use GOSUB, or GOTO. Incoming data is held in the receive queue during subprogram execu- 
tion, and the remote is held off by the interface when the queue is full, if handshaking between 
devices is active. If handshaking is not being used in Async operation, buffer overflow can 
occur. When handshake is being used, be sure that the remote computer does not disable the 
link when extended hold-offs occur. 

When interrupt service routines are subprograms accessed by an ON INTR... CALL statement, 
background subprograms may be temporarily suspended to allow interrupt processing. Be 
careful when using subprograms to be sure that variables are properly used for orderly flow of 
information between contexts. 

Most BASIC programmers, to maintain clarity in program flow, place interrupt service routines 
after the background routines. This technique simplifies documentation and makes it easier for 
others to understand program operation. The location of subroutines or program labels in 
BASIC programs does not affect efficiency or speed of execution by the desktop computer. 

A detailed discussion of background programs is beyond the scope of this chapter because they 
are dependent upon the individual application. In the example shown in this chapter, a simple 
idle loop is sufficient. A typical idle loop resembles the following statement: 

1880 BacK3round: GOTO BacKSround ! BaoK3round program idle loop. 

The next topics addressed are interrupt service routines for datacomm and keyboard opera- 
tions. 
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Interrupt Service Routines 

Interrupt service routines are required to service any peripheral device or interface that uses 
interrupt to access the computer. In the example we are using, interrupt service routines are 
required for the datacomm interface, computer keyboard, and softkeys. Each routine is treated 
separately in this section. 

Servicing Datacomm Interrupts 

Whenever the datacomm interface interrupts a running BASIC program, the interrupt request is 
first logged and then DISABLE INTR is automatically executed by the system. The cause of 
interrupt is then placed in STATUS Register 4. The interrupt service routine must do several 
things to guarantee that: (1) the interrupt is properly handled, (2) the interrupt structure is 
restored after the current interrupt is acknowledged, and (3) no data is left in the receive queue 
after the last interrupt request is processed. The following items outline the basic elements of 
the datacomm interrupt service routine (similar techniques are used for other interfaces). 

• Read STATUS Register 4 to clear the interrupt request and determine the cause of the 
interrupt. If you do not clear the interrupt request, it remains active and a new interrupt is 
generated as soon as you exit the service routine, whether or not there is any information 
to process. 

• Use ENABLE INTR (usually without specifying a new interrupt mask) to reactivate the 
datacomm interrupt system. It is usually unnecessary to redefine the interrupt mask when 
this is done. 

• Take appropriate action based on what caused the interrupt. 

• Exit the interrupt service routine with a RETURN (or equivalent statement as appropriate) 
taking care to maintain proper program structure. 

In most applications, interrupts are generated when data is available for transfer between the 
interface and your desktop computer. The interrupt service routine then processes the transfer 
using the ENTER statement. Here is an example of a typical datacomm interrupt service routine 
where A$ is dimensioned to a length of one character (DIM A$[l]). The calling sequence 
might be: 

ON INTR Sc GOSUB Datacomm 
ENABLE INTR Sc;Mask 

2030 Datacomiii;STATUS Sc (4 ! I n t e r rupt_c ause 

2100 ENABLE INTR Sc 

2110 Dc: STATUS Sc iS i Rx_que ue_5 1 at us 

2120 IF RK_queue_status=0 THEN RETURN 

2130 ENTER Sc USING "».-K";A$ 

2140 PRINT USING "« .K" !A$ 

2150 GOTO Dc 

While this interrupt service routine (ISR) looks deceptively simple, its structure performs 
several important functions: 

• Line 2090 acknowledges the interrupt and places the cause-of-interrupt information in 
Interrupt-cause. 

• Line 2100 reenables the interrupt without changing the mask. 
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• Line 2110 gets the receive queue status. Four values are possible: 

R X _ q 1.1 e 1.1 e _ s t a t u 5 = 0; Receive queue is empty. 

R X _ q u G u e _ 5 1 a t u 5 = 1 : Receive queue contains data. 

R X _<=! u e u e _ s t a t u s = 2: Receive queue contains at least one control block. 

Rx_queue_s t at us =3: Receive queue contains both data and at least one control 
block. 

• Line 2120 checks to make sure there is data or control information available before 
continuing. This prevents attempts to enter data that does not exist. The placement of this 
statement is explained under Exit Conditions. 

• Line 2130 enters the data. The format used guarantees that no data is lost during searches 
for end-of-line delimiters. The "#" IMAGE specifier prevents search for end-of-line (EOL) 
delimiters. Use of "-K" places CR, LF, and CR-LF end-of-line delimiters in the string 
variable when they are encountered. BASIC can then locate the delimiters by using 
separate operations. 

• Line 2140 prints the data on the current PRINTER IS device. The "#" specifier suppres- 
ses the EOL sequence because terminators are already contained in the string variable. 

• Line 2150 goes back to check for more data before exiting. This guarantees that no data is 
missed in the event that additional data arrives during interrupt service Otherwise, some 
interrupt requests may be missed. 



To understand why the interrupt is handled as shown, consider the following sequence of 
events: 

.Interface places data in queue and requests interrupt. 

ilnterface receives more data and requests a second interrupt. 
.Interface requests a third interrupt. 



to t1 t2 t3 t4 t5 

' I ISR begins processing second interrupt. 

I 'iSR finishes first interrupt. 

ISR acknowledges then reenables interrupt. 
It then begins entering the data. 
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At time tO, the interface places data in the receive queue and requests interrupt service. At tl, 
the ISR responds and acknowledges the interrupt. The interrupt is reenabled, but subsequent 
interrupt service requests are logged but not serviced until the routine is finished. While the ISR 
is processing the first interrupt request, a second and third request are made at t2 and t3. (The 
already active interrupt request line is reactivated by the third request. From the computer's 
point of view, nothing happened because the second interrupt request was already active). 
When the ISR completes the first interrupt process (t4), it exits, then acknowledges, the second 
interrupt (t5). 

Here is what really happens when the example routine is executed: Since the routine checks for 
no more data in the queue before it processes the interrupt, and remains in the ENTER/PRINT 
loop until the queue is empty, all available information is processed before exit occurs. There- 
fore, data placed in the queue at the time of the second and third interrupt requests is processed 
before the exit at t4, guaranteeing that nothing is left. When the second entry is made to the 
routine (t5) in response to the second interrupt request, no data is in the queue unless it was 
placed there between exit and reentry. In this case, the queue is empty, so exit is immediate. 
The third interrupt request cannot be recognized, because the second was still pending when it 
occurred. 

If the routine were written differently, and only one ENTER statement was executed for each 
interrupt request, the example sequence would result in only two interrupts being acknow- 
ledged. The third interrupt request and its corresponding data would not be processed until a 
fourth request caused the third data entry to be executed. Such a structure presents a risk of 
data loss. 

Exit Conditions 

In the preceding example, line 2120 exits or continues the interrupt service routine, depending 
on the status of the receive queue. The example shown assumes that A$ can hold only a single 
ASCII character or data byte. The ENTER statement is terminated as soon as A$ is filled, so 
data transfer is one byte at a time. By checking for Status Register 5 = 0, you are guaranteed 
that no data messages remain in the receive queue. Control blocks are immaterial in this case. 

When using Data Link protocol, most programmers specify data transfer formats of one record 
per block. This eliminates the need to search data for delimiters^ Since the datacomm interface 
can receive Data Link transmission blocks up to 1000 characters, it is wise to dimension A$ to a 
length exceeding the maximum expected block length; for example, DIM A$C1050].In such 
cases, it is necessary to modify line 2120 to provide exit if a full block is not available for A$. 
Instead of examining for the presence of data, a test is made to look for a control block in the 
queue, indicating the presence of a full block of data. (Control Register 14 must be set so that 
only ETB/ETX terminators are allowed to create a control block. ) If a control block is present, a 
full block of data is also available. When the ENTER statement is executed, the input operation 
terminates when the control block is encountered, and the resulting length of A$ matches the 
received block length. To operate in "block mode" instead of "character mode" as earlier, 
change line 2120 to: 

2120 IF Rx_aMail_bits<2 THEN RETURN 

Only the dimension of A$ is affected by this change. Other interrupt service routine statements 
remain unchanged. 

1 The HP 3000 packs multiple records per block when transferring ASCII text files, so you must decode delimiters to find record boundaries. 
Consult the appropriate HP 3000 Data Link manuals for more information. 
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Note 

It is good programming practice to be sure the receive queue or input 
buffer is completely empty before exiting an interrupt service 
routine, and make sure there is data present before trying to process 
it. 

This example datacomm interrupt service routine is adequate for most applications where data 
is not sent with a known, fixed format, and where prevention of data loss is important. In other 
situations, where loss of data between the end of the input variables list and the delimiter in 
incoming data is unimportant, or a fixed format is used, other formats can be specified. It is 
usually wise to avoid using multiple variables with the ENTER statement when using the 
formats shown in this example. Here's why: 

A control block indicates End-of-data, not End-of-information. Consequently, an ENTER state- 
ment is terminated whenever a control block is encountered (variables are terminated by EOI, 
not EOD). If more than one variable is included in the statement, and EOD (control block) 
occurs before the list is filled, the unfilled variables retain their previous values which can lead to 
improper results. 

Data Formats for Datacomm Transfers 

All datacomm data transfers use the OUTPUT and ENTER statements. Consequently, any 
formatting techniques that are compatible with these statements can also be used. However, 
since most computers send and expect to receive a limited variety of data formats, most data 
transfers use a limited assortment of formats. 

ASCII Data Transfers — In asynchronous data communications applications, information is 
usually transferred as lines of ASCII text. In most cases, lines are terminated by a carriage- 
return followed by a line-feed (CR-LF), or by a carriage-return only. Other methods may be 
used occasionally to recognize record boundaries in special applications. 

Most Data Link applications consist of ASCII text records transferred between the network host 
computer and other terminals and/or computers in the network. Records are transmitted in 
blocks, one or more records per block. When multiple -record blocks are transferred, delimiters 
between records are included as part of the text, and individual records must be unpacked by 
the receiver. 

Non-ASCII Data Transfers - Non-ASCII data includes non-text or non-ASCII text data that 
must be transmitted over the datacomm link, but may contain characters that could be inter- 
preted as datacomm control characters. Examples of non-ASCII data includes encoded data 
files, non-text program files, or specially formatted data. To provide a means of transferring 
non-ASCII data formats requires non-standard techniques in Async, and transparent transmis- 
sion when using Data Link. 

To transfer non-ASCII data using asynchronous protocol, use an eight-bit character format with 
or without parity as dictated by your application. End-of-line and prompt recognition, and any 
character stripping functions must be disabled to allow passage of arbitrary character patterns. 
Use of Async for such applications is uncommon, primarily because of the limited reliability of 
parity checks as a means for error detection. 
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Transfer of non-ASCII data using Data Link protocol is much easier because all data transmit- 
ted by the desktop computer through the datacomm interface is sent as transparent data; i. e., 
data that could be mistaken for control characters is transferred intact. Data Link transfers from 
the network host are also sent as transparent data. In order to transfer non-ASCII data from the 
network host, a cooperating program on the host must originate the data, and suppress end-of- 
line and other unwanted character sequences. 

Servicing Keyboard Interrupts 

The keyboard interrupt service routine has several functions. In the case of a terminal emulator 
or similar application, it inputs keystrokes, interprets them, then transmits the results to the 
datacomm interface. In addition, it may be required to display the keystroke(s) or perform 
backspace and editing operations (such as in line-mode terminal emulators). Certain keys may 
also be reserved to perform program command functions while others are used to transmit 
information to the host. 

Here is a simple example of a keyboard interrupt service routine that sends ASCII keystrokes to 
the datacomm interface as each key is pressed, then sends an end-of-line (CR) if Async, or 
end-of -block if Data Link. The example shown is for Async protocol; Line 2410 is changed for 
Data Link. The calling sequence might be ON KBD GOSUB K e y b o a r d . An explanation follows 
the example. 



2290 


Keyboard 


l:K*=KBD* 




2300 


K: IF 


NOT LEN(K*) THEN 


RETURN 


2310 


Key 


•=NUM(K$) 




2320 


K* = 


:K$C2] 




2330 


IF 


Key=255 THEN 




2340 




Key=NUM(K*) 




2350 




K*=K[23 




2360 




IF Key=255 THEN 




2370 




Key=NUM(K*) 




Z380 




K*=K*C2] 




2390 




END IF 




2400 




IF Key=NUM("E") 


THEN 


2410 




OUTPUT Sc;CHR*(13) 


2420 




ELSE 




2430 




BEEP 




2440 




END IF 




2450 


ELSE 




24B0 




OUTPUT Sc iCHR*(Key) 5 


2470 


END IF 




2480 


GOTO K 





To change the example for Data Link, eliminate the carriage return in line 2410 as follows: 

2410 OUTPUT ScJEND 

This Async example assumes that the host echoes any data sent to it; that is, when a character is 
sent to the host, the host sends the same character back to the terminal where it is displayed. 
Consequently, keystrokes are displayed AFTER they are returned by the host. Data Link 
protocol does not provide this feature (called echo-plex). To print each keystroke on the CRT 
as it is keyed in, add the following line to the Data Link example: 

2465 PRINT CHR*(Key ) ! 
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This keyboard routine is a good illustration of how to use an IF... THEN.,. ELSE structure to 
decode a keystroke, and decide whether it is ASCII, end-of-line, or an unrecognized character. 
If ASCII, it is transmitted. If the ENTER key is pressed, it sends an EOL. Any other key is 
ignored, but the computer beeps to acknowledge the keystroke. 

To understand the routine, you must be aware that several data formats are found in KBD$. 
ASCII keystrokes are stored, one byte per stroke, as key codes equivalent in value to the NUM 
value of the corresponding ASCII character code. Non-ASCII keys are stored as two bytes; the 
first byte is CHR$(255), the second byte is the keycode. If the CONTROL key is pressed 
simultaneously with a non-ASCII key, a three-byte entry is made in KBD$. The first is 
CHR$(255) representing a non-ASCII key, the second is also CHR$(255) representing the 
CONTROL key, and the third byte is the keystroke. Keycode values for non-ASCII keys are 
listed in the Keyboard Output Codes table in the back of the BASIC Language Reference for 
your computer. The following table shows the KBD$ data format for each keystroke: 



Keystroke(s) 


First Byte 


Second Byte 


Third Byte 


ASCII or CONTROL-ASCII 
Non-ASCII Key 
CONTROL-Non-ASCII Key 


ASCII keycode 

CHR$(255) 
CHR$(255) 


None 

Non-ASCII keycode 

CHR$(255) 


None 
None 
Non-ASCII keycode 



The contents of KBD$ is destroyed when you transfer it to another string or perform any other 
operation on KBD$. Since only one read from KBD$ is possible, K$ is used as a temporary 
storage and work area for the contents of KBD$, permitting additional string operations. 

The first IF.. .THEN.. .ELSE looks for a CHR$(255) indicating a non-ASCII key. If none is 
found, the ASCII key is sent to the datacomm interface. The second IF... THEN... ELSE is 
entered ONLY if the first character indicates a non-ASCII key. It looks for a second CHR$(255), 
which is discarded, if found. (Both ENTER and CTRL-ENTER are accepted as end-of-line. ) The 
keystroke data byte is then checked to see if it is the ENTER key. If the value is not equivalent to 
NUM("E"), the key is rejected. Otherwise, and end-of-Iine/end-of-block is sent to the data- 
comm interface. 

In more elaborate applications, other keys such as backspace or other cursor control characters 
could be interpreted, and the CRT display and other program parameters varied accordingly. 

Note that the interrupt service routine remains active until the entire contents of KBD$ as it 
existed at time of interrupt is processed. If, in the meantime, more keystrokes are placed in 
KBD$, a new interrupt occurs as soon as the service routine is finished. 

Service Routines for ON KEY Interrupts 

ON KEY interrupt service routines are usually simpler than ON KBD service routines. The tasks 
are usually well-defined and relatively simple. In this example, KEY disconnects the data- 
comm line, and KEY 1 sends a BREAK. The routines are implemented as follows: 

To send a BREAK on either Async or Data Link, set bit zero of Control Register 6. Here is how: 

2520 BreaK:CONTROL Sct6!l 
2530 RETURN 
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To disconnect from the datacomm line, clear Control Register 12 as follows: 

2570 Disoo:CONTROL Sg»12;0 
2580 DISP "Disconnected" 

2590 END 

You now have a working terminal emulator. 



Cooperating Programs 

Some applications, while similar in some respects to terminal emulators, require unattended 
operation of the desktop computer and network host. In such cases, cooperating programs on 
the host and terminal computer are used. Applications can include such things as the desktop 
computer controlling a local data gathering system, making preliminary calculations, and send- 
ing the results to the network host. Since data integrity is important in such cases, Data Link is 
frequently used because of its ability to detect transmission errors. 

Here is an example of cooperating programs you can run on your desktop computer and an HP 
1000 Data Link network host computer. The FORTRAN program COOP runs on the HP 1000, 
and is responsible for opening and transferring the specified file(s) from the HP 1000 to the 
Data Link. A cooperating BASIC program on the desktop computer acts as an interface be- 
tween the operator and the HP 1000. The specified file is transferred from the Data Link to local 
mass storage as it is received from the HP 1000. Assuming the file is an ASCII program file 
containing valid BASIC statements, it can then be attached to the cooperating program and 
run. Note that variables used by both the original BASIC program and the downloaded prog- 
ram must be specified as COM variables to prevent destroying their values during pre-RUN 
initialization of the downloaded program. The program listings are as follows: 

FORTRAN Program COOP for the HP 1000: 

FJNa »L 

PROGRftM COOP 

C This is a FORTRAN program that, runs on the HP 1000 and cooperates 

C with a compatible p r o 3 r a m r u n n i n S simultaneously on a d e 5 K t o p 

C computer. 

C 

C This program waits in I/O suspend until the desKtop computer returns 

C a file name. When the name is receiuedt it is parsed, and the 

C success status of the parse is sent to the desKtop computer. If the 

C file name parses successfully, this proSram tries to open the file. 

C The status of the OPEN is also sent to the desKtop computer. 

C 

INTEGER DCB( 144) .IDBUF( 10) .IBUF(80) 

INTEGER NAMEO) ,SCODE .CRN 

INTEGER DTC. ERROR. OK 

EOUIUALENCE (NAME .IDBUF) .(SCODE .IDBUF(5) ) , ( CRN , I DBUF ( E ) ) 

C **#INITIALIZE DTC TO BE THE LU» OF THE DESKTOP COMPUTER*** 

DTC=21 

C **»Send the ASCII strinS "SYNCHRONIZE" to the desktop computer*** 
C This sisnals the desktop computer to besin executing the sister 
C proSram to this one. 
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CALL EXEC (2 ,DTC , 1 1 HS YNCHROIMI ZE ,-11) 

C ♦♦♦Now wait in I/O suspend until the desktop computer sends t h e ♦ * ♦ 
C name of the proSram file that is to be downloaded to the 
C d e s K t p computer. 

CALL EXEC( 1 iDTC ,IBUF t-aO) 

CALL ABREG( lA ,LEN) 
IP=1 

IF ( NAMR ( IDBUF iIBUF .LEM ,IP) ) 9200,100 

100 CALL EXEC ( 2 ,DTC ,2H0K , -2 ) 

C ♦♦♦OPEN THE FILE AND SEND THE CONTENTS TO THE DESKTOP COMPUTER+^^ 

IF ( OPEN (DCB .ERROR ,NAME ,0 ,SCODE .CRN) ) 9100,200 
200 CALL EXEC ( 2 ,DTC ,2H0K , -2 ) 

250 CALL READF(DCB .ERROR .IBUF ,80 .LENGTH) 
IF (LENGTH ,E0 ,-1 ) GOTO 300 
CALL EXEC (2 .DTC .IBUF .LENGTH) 
GOTO 250 

C ♦♦♦TELL THE DESKTOP COMPUTER THAT THE END OF FILE HAS BEEN^^^ 
C REACHED , THEN STOP, 

300 CALL EXEC(2 .DTC .IIH^ENDOF- ILE^ ,-1 1 

STOP 

C ♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦+♦♦♦ 

C ERROR HANDLING ROUTINES 

C ♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦+♦♦♦ 

C ♦♦♦♦♦♦♦♦♦♦♦♦♦THIS ROUTINE HANDLES DISC ERRORS++^^^^^^^+^^^+^^^+^^^ 
C BY SENDING THE FMP ERROR AND CLOSING THE FILE. 

9100 WRITE(DTC ,3101 )ERRDR 

9101 FORMAT ("THE OPEN FMP ERROR CODE NAS "IG) 
CALL CLQSE(DCB) 

STOP 

C ♦♦♦♦♦♦♦♦♦♦♦♦THIS ROUTINE HANDLES PARSING ERRDRS++^+^^+^+^^^^^^+^^+ 

9200 NRITE(DTC ,9201 ) 

9201 FORMAT ("THE FILE NAME RECEIOED DID NOT PARSE CORRECTLY") 
STOP 

END 



The Datacomm Interface 297 



Cooperating BASIC Program for the Desktop Computer: 



1000 
1010 
1020 
1030 

loao 

1050 
lOGO 
1070 
1080 
1030 
1100 
1110 
1120 
1130 

uao 

1150 

iieo 

1170 
1180 
1130 
120 
1210 
1220 
1230 
1240 
1250 
12B0 
1270 
12B0 
1230 
1300 
1310 
1320 
1330 

i3ao 

1350 
13G0 
1370 
1380 
1330 

laoo 
laio 
lazo 
ia30 
laao 

1450 
14G0 
1470 
1480 
1430 
1500 
1510 
1520 
1530 
1540 
1550 
15B0 
1570 
1580 
1530 
IBOO 
1 B 1 
1S20 
1B30 
1B40 
1B50 
IBGO 



♦*♦♦♦«•»*»**♦♦♦♦♦*♦*♦*♦**♦*♦♦**«****♦♦♦♦*♦♦♦♦♦«♦»♦♦♦**»♦♦♦»*♦♦♦*♦♦♦*♦*♦«♦ 
This BASIC proSram cooperates with the FORTRAN proSram "COOP" and 
downloads a BASIC prosram file from the HP 1000 for execution on 
the desktop computer. While the proSram is not eleSantt it 
illustrates the basic concepts inuolued in down load in 3 files to 
local mass storaSei then loadinS them into memory for execution. 
The same technique is useful for transferrins data files. 

************************************************************************ 



COM Sc tlnsep$[4] .ProfflPt*[2] 



The ualues of these uariables must be 

preserued between programs. 

Set select code. 

Set UP data transfer strings. 



Sc = 20 

DIM Rx$[1050] ,Tx*[1050] 

Insep$=CHR$( 13)&CHR$( 10)&CHR$(27)&:"_" ! HP 1000 EOL strinS. 

Esc_u_5co re$ = CHR*(27)&:"_" ! Es cape -Un d e rsc o re . 

INTEGER A 

************************************************************************ 
Set UP DATA LINK protocol 



Reset the interface. 
Set Data LinK protocol. 



Wait; 



CONTROL So .Oil 

CONTROL Sc .3i2 

STATUS Sc ,3B!All_5ent 

IF NOT AlI_SBnt THEN Wait ! Wait for control blocK sent. 

CONTROL SctOil ! Reset interface to start new protocol. 



************************************************************************ 
Set UP the datacomm configuration. 



CONTROL Sc flSiO 

CONTROL Sc ,17i0 

CONTROL Sc (20! 14 

CONTROL Sc ,21 il 

CONTROL Sc .22;i 

CONTROL So »23!0 

CONTROL Sc ,24 !0 

CONTROL Sc ,3B!0 



Disable Connect timeout. 
Disable No Activity timeout. 
Set baud rate to 9S00. 
GID="A" . 
DID="A" . 

Due r ride default switches and set 
! Hardware Handshake OFF, n on -mod em connection. 
Transmit block lenSth maximum: 512 bytes. 
Set parity: NONE (HP 1000 connection). 



#»♦♦*♦♦♦♦»♦♦♦♦**♦*♦♦♦♦»*♦*♦»♦*»♦#»♦***«**»♦*•»*»♦*»***♦»**♦««♦««♦*♦**♦*♦* 
Connect to the Data Link. 



Conn i 



CONTROL Sc,12il ! Send connection command to the interface, 
D I S P " T r y i n S to connect" 
STATUS Sc ,12 iLine-state 

IF Line_state<>3 THEN Conn ! Wait for connection complete. 

D I S P "Connected" 



♦«♦♦♦♦«♦♦♦»♦*♦»♦♦•»*♦*»*♦♦♦♦*♦»«**♦*»♦*♦♦*♦♦«♦*♦♦♦*♦♦♦♦♦♦♦♦»**»♦********« 
This is a MINIMAL Terminal Emulator. 



Prompt ! 



! 
Idle: 



LINPUT Tx$ 

PRINT USING "« ,K" !Tx* 

OUTPUT Sc;Tx$iEND 

STATUS Sc ,5 iReceiue 

IF NOT Receive THEN Idle 



! Get line to send to network host, 

! Print line on CRT. 

! Send line to host. 

! Look for reply from host. 

! If nothinS, try aSain. 



ENTER Sc USING "«,-K"iRx$ ! Get reply message. 

PRINT USING "« ,K" iRx*Cl ,POS(Rx* ,Esc_u_score*)-n ! Print reply. 

Trap messages from HP-1000: 

IF PaS(RK$ ."UNABLE TO COMPLETE LOG-ON") THEN Prompt ! If error, 

IF POS(Rx*,"END OF SESSION") THEN Prompt ! try aSain. 

IF POS(Rx* , "SYNCHRONIZE" ) THEN Coop ! When syn oh ron i : ed , start. 
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1B70 
1B80 
1B90 
1700 
1710 
1720 
1730 

i7ao 

1750 
17G0 
1770 
17B0 
1790 
1800 

1 81 
1820 
1830 
1840 
1850 
18G0 
1870 
1880 
1890 
1900 
1910 
192 
1930 

is^ao 

1950 
19B0 
1970 
1980 
1990 
2000 
2010 
2020 
2030 
2040 

2 5 
20B0 
2 7 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
2 ISO 
2170 
2200 



STATUS Sc .5 iRecG lue 



IF NOT Receiue 
GOTO Idle 



AND 



! Loot; for line with EOL 
! If not CrLfEsc_f it is 
! system prompt from the 
! So to idle loop. 
(POS{Rm$ .Insep$) =0) THEN Prompt 



oharEicters missin 
a s y 5 t e m or s n b - 
HP 1 ij . Other w i s 



I 



Prompt' 
No. 



»♦*«♦**♦*#*♦**♦♦#**♦♦*♦*♦**♦♦««♦***♦**♦♦♦♦**»*♦****♦♦♦♦*«■»■*»*♦♦♦♦***♦♦♦♦ 
This section starts the cooperatinS proSram. 



Cot 
Tl ; 



Rl 



! 

R2: 



LINPUT "TYPE IN A FILE NAME" ,Tx$ 
STATUS Sc ,4 STrar smit 
IF NOT BIT( 1 .Transmit ) THEN Tl 
OUTPUT SciTx$;END 

STATUS Sc .5 ;Rece lue 
IF NOT Receiue THEN Rl 

ENTER Sc USING "tt,-K";Rx$ 
IF POS(Rx$ )"DK" ) THEN R2 
PRINT Rx$ 
STOP 

STATUS Sc .SiRecG ive 

IF NOT Receiue THEN R2 

ENTER Sc USING "«.-K";Rx$ 
IF P0S(Rx$ ."OK" ) THEN Rd_proS 
PRINT Rx$ 
STOP 



Get file name for transfer. 
Get transmit =i i.i e u e status. 
If not empty. i»i a i t . 
Send file n a m e . 

Get receiue queue status. 

If empty, wait for data. 

Get data. Keep CR-LF. 

If D K I continue. 

Not OK. Print error message. 

Error. STOP . 

L K for another OK from 
the HP 1000. 

If OK. start download. 

Not OK. Print error messaSe. 

Error. STOP. 



Rd- 

I 

R3: 



For this section to work, the HP 1000 must send the 4 - c h a r a c t e r 
e n d - f - 1 i n e sequence: CR-LF followed by e s c a p e - c o d e . underscore. 
Auto-answer must be disabled) and the data beins sent from the 
HP 1000 MUST consist of u a 1 i d BASIC p r o 9 r a m lines, each i n c 1 u d i n 9 a 
u a I 1 d 1 1 n e n u m b e r . 

.pros: ! ASSIGN @File TO "DOWNLOAD" ! Assign destination file for 

file transfer. 
STATUS Sci5!Receiue ! Look for data record. 

IF NOT Receiue THEN R3 ! If nothinSi wait for record. 

ENTER Sc USING "»,-K";Rx$ ! Get record. K i? e p CR-LF. 
PRINTRx$ ! Print record on printer. 

IF POS(Rx* ."»ENDOFFILE*" ) THEN Get_pro9 IChecf; for end-of-file. 
OUTPUT @Fi le ;frx$ .C 1 fPOSCRx* ,E5C_u_5C0 re ) - n ! Store record on 
GOTO R3 ! Mass StoraSe file and repeat for next record. 
I 

Get_pro9: ! File has been downloaded to local mass stDra:*e. 
ASSIGN @File TO ♦ ! Close the file. 

GET "DOWNLOAD" .2200 .2200 ! Get the downloaded proSram, 



END 



! This statement is destroyed by GET. 



Program File to be Downloaded from the HP 1000: 



1 
1 1 
1020 
1030 
1040 
1050 
lOGO 
1070 
1080 
1090 
1 100 
lUO 



This p r S r a m is downloaded to the desktop computer for execution 

DIM A$C20] 

INPUT "HI. I'm the downloaded pros ram. What is your name?". A* 

PRINT "Now I'll count to 10." 

FOR 1=1 TO 10 

PRINT " :";i 

NEXT I 

PRINT "That's the end of the demo!!" 
PRINT "Nice to meet you. ";A$ 
GOTO Idle 
END 
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Modified Cooperating BASIC Program After Loading: 



2080 
2090 
2100 
2110 
2120 
2130 

2iao 

2150 
21 BO 
2170 
2200 
2210 
2220 
2230 
2240 
2250 
22G0 
2270 
2280 
2290 
2300 
2310 



Get_proS: 



ENTER Sc USING "«>-K"!Rx* ! Get record. Keep CR-LF, 
PRINT Rx* . ! Print record on printer. 

IF POS(Rx$ ."♦ENDOFFILE*") THEN Get_pro3 IChecK for end-of-file. 
OUTPUT @Fi le iRx$ i[ 1 .POS(Rxt tEsc_ij_sco re) -1 ] ! Store record on 
GOTO R3 ! Mass StoraSe file and repeat for next record. 

! File has teen downloaded to local mass storaSe. GET it. 
ASSIGN SFile TO * ! Close the downloaded file first. 

GET "DOWNLOAD" .2200 ,2200 ! Get the dounloaded proSram. 

This program is dounloaded to the desKtop computer for execution. 



DIM A*C20] 

INPUT "HI. I'm the downloaded proSram. 

PRINT "Now I'll count to 10." 

FOR 1=1 TO 10 

PRINT " :"il 

NEXT I 

PRINT "That's the end of the demo!!" 
PRINT "Nice to meet you, ";A$ 
GOTO Idle 
END 



What is '/our name?", A* 



Results: 

Assuming you have logged onto the HP 1000, the printed output that is displayed on the CRT 
screen or current PRINTER IS device should look something like this: 



RU ,COOP 
SYNCHRONIZE 
TYPE IN A FILE NAME 
FAB2: : 10 

HI, I'm the downloaded proSrain. 
SUE 

Now I'll count to 10 
1 

:3 

:4 

:5 

:G 

;7 

:8 

:9 
10 

That's the end of the demo!! 
Nice to meet you SUE 



What is your name' 



COOP 



STOP 0000 



EX 

$END FMGR 

FMG21 REMOVED 



SESSION 21 OFF 1:26 PM FRI., 11 SEP.. 1981 
CONNECT TIME: 00 HRS., 08 MIN., 28 SEC. 

CPU USAGE 00 HRS., 00 MIN., 00 SEC. 

CUMULATIVE CONNECT TIME 01 HRS. , 09 MIN. , 02 SEC. 
END OF SESSION 



a70 MS. 
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Datacomm Errors and Recovery Procedures 

Several errors can be encountered during datacomm operation. They are listed here with 
probable causes and suggested corrective action. 



Error 



Description and Probable Cause 



306 



313 



314 



315 



316 



317 



318 



319 



Interface card failure. This error occurs during interface self-test, and indicates an i nteface 
card h ardw are ma lfunction. You can repeat the power-up self-test by pressing [ SHIFT ] 
[pause] (or (reset] ). If the error persists, replace the defective card. Using a defective 
card may result in improper datacomm operation, and should be considered only as a 
last resort. 

USART receive buffer overflow. The SIO buffer is not being cleared fast enough to 
keep up with incoming data. This error is uncommon, and is usually caused by 
excessive processing demands on the interface microprocessor. To correct the 
problem, examine BASIC program flow to reduce interference with normal inter- 
face operation. This error causes the interface to disconnect from the datacomm 
line and go into a SUSPENDED state. Clear or reset the interface card to recover. 

Receive Buffer overflow. Data is not being consumed fast enough by the desktop 
computer. Consequently, the buffer has filled up causing data loss. This is usually 
caused by excessive program demands on the desktop computer CPU, or by poor 
program structure that does not allow the desktop computer to properiy service 
incoming data when it arrives. Modify the BASIC program(s) to allow more fre- 
quent interrupt processing by the desktop computer, or change to a lower baud 
rate and/or use protocol handshaking to hold off incoming data until you are ready 
to receive it. This error causes the interface to disconnect from the datacomm line 
and go into a SUSPENDED state. Clear or reset the interface to recover. 

Missing Clock. A transmit timeout has occurred because the transmit clock has not 
allowed the card to transmit for a specified time limit (Control Register 19). This 
error can occur when the transmit speed is (external clock), and no external clock 
is provided, or be caused by a malfunction. The interface is disconnected from the 
datacomm line and is SUSPENDED. To recover, correct the cause, then reset the 
card. 

CTS false too long. Due to clear-to-send being false on a half-duplex line, the 
interface card was unable to transmit for a specified time limit (Control Register 
19). The card has disconnected from the datacomm line, and is in a SUSPENDED 
state. To recover, determine what has caused the problem, correct it, then reset or 
clear the interface card. 

Lost Carrier disconnect. Data Set Ready (DSR) (and/or Data Carrier Detect, if 
full-duplex) went inactive for the specified time limit (Control Register 18). This 
condition is usually caused by the telecommunications link or associated equip- 
ment. The card has disconnected from the datacomm line and is in a SUSPENDED 
state. To recover, clear or reset the interface card. 

No Activity Disconnect. The interface card disconnected from the datacomm line 
automatically because no information was transmitted or received within the time 
limit specified by Control Register 17. The card is in a SUSPENDED state. Clear or 
reset the interface to recover. 

Connection not established. The card attempted to establish connection, but Data 
Set Ready (DSR) (and Data Carrier Detect, if full duplex) was not active within the 
time limit specified by Control Register 16. The card has disconnected from the 
datacomm line and is in a SUSPENDED state. Clear or reset the interface to 
recover. 
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Error I Description and Probable Cause 



325 



326 



327 



Illegal DATABITS/PARITY combination. CONTROL statements have attempted 
to program 8 bits per character and parity "1" or "0". The CONTROL statement 
causing the error is ignored, and the previous setting remains unchanged. To 
correct the problem, change the CONTROL statement(s) and/or interface default 
switch settings. 

Register address out of range. A CONTROL or STATUS statement has attempted 
to address a non-existing register. The command is ignored, and the interface card 
state remains unchanged. This error can also occur when illegal HP-IB statements 
are used with this interface. 

Register value out of range. A CONTROL command attempted to place an illegal 
value in a defined register^ The command is ignored, and the interface card state 
remains unchanged. 



Error Recovery 

When any error from Error 313 through Error 319 occurs, it forces the interface card to 
disconnect from the datacomm line. When a forced disconnect terminates the connection, the 
interface is placed in a SUSPENDED state, indicated by Status Register 12 returning a value of 
4. The interface cannot be reconnected to the datacomm line when it is SUSPENDED. CLEAR, 
ABORT, and RESET are used to recover from the suspended state and resume normal card 
operation. Executing OUTPUT and CONTROL statements while the card is suspended places 
corresponding data and control block(s) in the transmit (outbound) queue and can continue to 
do so until the queue is filled, at which time the desktop computer operating system hangs. 
ENTER statements can be executed to retrieve data that was there prior to SUSPEND until the 
receive (inbound) queue is empty. Subsequent ENTER statements, if executed while the card is 
suspended, hang the computer. 

To recover from a SUSPENDED interface, three programmable options are available, all of 
which destroy any existing data in the transmit and receive queues. They are: 

• The CLEAR statement clears the receive and transmit queues. In addition, if the interface 
card is suspended, it disconnects the card from the datacomm line. If the card is not 
suspended, its connection state is not changed, but the queues are cleared. 

• The ABORT statement is identical to the CLEAR statement, except that the interface card 
is unconditionally disconnected from the datacomm line. 

• RESET interface (Control Register 0) clears all buffers and queues, and resets all CON- 
TROL options to their power-up state EXCEPT the protocol which is determined by the 
most recent CONTROL statement (if any) addressed to register 3 since power-up. 

A fourth (keyboard only) option is available. ( SHIFT ] (PAUSE) (or ( RESET) ) causes a hardware reset to 
be sent to ALL peripherals. This completely resets the datacomm interface to its power-up state 
with protocol and other options determined by the default switch settings. 

Error Detection and Program Recovery 

When a timeout or datacomm error occurs, an interrupt is generated by the interface card to 
BASIC. If an ON ERROR is active for that select code, the error is trapped and handled by the 
error routine specified by the ON ERROR statement. If no ON ERROR is active for that select 
code, the program is stopped at the end of the current line by the BASIC operating system, and 
an error message is sent to the PRINTER IS device. 
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When a datacomm error is trapped by an error routine, the routine must decide what to do 
about the problem. Options include the suggested recovery techniques discussed previously 
with the error messages, or orderly prograrfi termination. The options you select are deter- 
mined by your specific application. Since datacomm interface errors are not related to a specific 
program line, the ERRL function is always false, and ERRN returns the error number generated 
by the interface card. ERRL and ERRN are discussed in greater detail in the BASIC Program- 
ming Techinques manual for your desktop computer. 



Terminal Emulator Example Programs 

The following pages contain complete listings of two terminal emulator programs based on the 
preceding discussion. The first program is for asynchronous data communication with an HP 
1000. It can be easily adapted for other remote computers and different operating parameters. 
The second program uses Data Link to communicate with an HP 1000 network host. It can be 
used with the HP 3000, but the parity specifier must be changed, and other changes made as 
appropriate. 

Both programs can be enhanced and expanded to include many additional features. The 
examples shown illustrate the general structure of terminal emulator programs, and are recom- 
mended as a basis for developing your own. 



Other example programs are also included for your convenience and to further illustrate some of 
the concepts discussed in this chapter. If you have an HP 46020 keyboard, you need to adjust the 
ON KEY LABEL statement in line 1750 (and any other affected lines). 



1 
1010 
1020 
1030 

loao 

105 
lOGO 
1070 
1080 
1090 
1100 
1 1 1 
1120 
1 130 

1 lao 

I 150 

II GO 
1170 
1180 
1190 
1200 
1210 
1220 
1230 
1240 
1250 
12B0 
1270 
1280 
1290 
1300 
1310 
1320 



♦♦*♦♦♦♦♦*♦♦♦♦»♦♦♦♦♦#♦♦♦*♦♦♦*♦♦*♦«♦*♦***♦♦*#***♦♦♦♦*♦♦♦♦»*♦♦**#*♦♦♦♦**♦ 

♦ * 

♦ ♦♦♦♦♦Example As'/nc Terminal Emu 1 a t a r^^ + ^^ ♦ 

♦ ♦ 
♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦*♦♦♦«♦♦♦♦♦♦♦»♦♦♦♦♦♦♦♦♦♦♦♦♦♦»*♦♦♦♦♦♦♦♦«♦♦♦♦ 

♦ This sample terminal emulator prosram is a simple eKan-ple of the ♦ 

♦ prosram structure at Seneral-purpose emulators. It is not elesantt^ 

♦ but contains the essential elements and illustrates commonly used * 

♦ prosrammins techniques. ♦ 
♦♦♦♦♦♦♦«*♦»♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦♦»♦♦*♦♦♦♦♦♦♦♦♦♦♦♦♦*♦*♦♦♦♦♦♦«♦♦♦♦♦♦♦♦♦♦♦♦♦♦ 



Sc = 20 

DIM A*Cn ,K*[100] 



Select code of datacomm interface. 
Set UP s t r 1 n 9 variables. 



Reset datacomm interface and enable Asvnc protocol. 



CONTROL Sc ,0!1 
CONTROL Sc »3;i 
Wait:STATUS Sc .38 ! All _5 e n t 

IF NOT All_5ent THEN Wait 
CONTROL Sc .0! 1 



Reset card to disconriect from line. 

Select Async protocol. 

Wait until Control Bloct; is sent to 

interface before resetting aSain. 
Reset card to start riew protocol. 



Set UP datacomm options. Normally just a few are included in the 
p r s r a m . This 9 r o u p o u e r r i d e s ALL defaults including s ai i t c h e s . 



CONTROL Sc ,ia;3 

CONTROL Be ,15!0 

CONTROL Sc ,lBiO 

CONTROL Bo .IViO 



CONTROL 5o 
CONTROL Sc 
CONTROL 



1S;40 

1 9 ; 1 

Be . 2 i 7 



CONTROL Be ,21 ;7 



Set Control BlocK masK for EOL and Prompt. 
No modem 1 i n e - c h a n 9 e notification. 
Disable connection timeout. 
Disable No Activity timeout. 
Lost Carrier 400 ms (default). 
Transmit timeout 10 s (default). 
Transmit Speed: 300 baud. 
Reeeiue Speed: 30 b a u d . 
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1330 
1340 
1350 
1360 
1370 
1380 
1390 
1400 
1405 
1410 
1420 
1430 
1440 
1450 
14B0 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
15G0 
1570 
1580 
1590 
IGOO 
IGIO 
1G20 
1G30 
1640 
1650 
1660 
1670 
16B0 
1690 
1700 
1710 
1720 
1730 
1740 
1750 
1760 
1770 
1780 
1790 
1800 
1810 
1820 
1830 
1840 
1850 
1860 
1870 
1880 
1890 
1900 
1910 
1920 
1930 
1940 
1950 
19G0 
1970 
1980 
1990 
2000 



CONTROL Sc (22 112 

CONTROL Sc .23 ;i 

CONTROL Sc .24566 

CONTROL Sc .26,6 

CONTROL Sc .2755 

CONTROL Sc .2852 .13 -. 

CONTROL Sc ,31 51.17 



CONTROL 
CONTROL 
CONTROL 
CONTROL 
CONTROL 



Sc .3452 
Sc .35 50 
Sc .36 5 1 
Sc .37 5 
Be .3954 



EO/AK (as terminal) handshake. 
Full Duplex Modem connection. 
Remoue protocol characters except 

EOL. ChanSe errors to underscores. 
AssiSn "AK character for EO/ftK. 
AssiSn EO character for EO/AK. 

! Set EOL se-iuence to CR/LF (default). 
Set prompt to be DCl (default). 

Reiister 33 is not used. 
Seuen bits per character. 
One stop bit per character. 
Odd parity. 

No inter-character time Sap (default). 
Set BREAK to four character times (default) 



You are now ready to -connect to the remote computer. Optionally, this 
may include autodialinS with the HP 132S5A Modem. 



CONTROL Sc .1252 

OUTPUT Sc5"> 9 @ (303) 555-1234" 



! Start Autodial. 

! Send telephone number strini. 



I I Unrecognized characters are isnored. 

I Insert 1-second pause (used with PBX to wait for 

Select FAST dialinS rate. dial tone). 

Autodialin* is not started until Start Connection is initiated by the 
followins CONTROL statement: 



CONTROL Sc .1251 



! Start the connection. 



If desired, this is the proper place to monitor STATUS ReSister 12 to 
see if the connection is actually made. 

ConniSTATUS So . 1 2 5 Li n e_s t at e ! Get Line State from STATUS Register. 
IF Line_state=2 THEN DISP "DialinS" ! State=2. 

IF Line_state=l THEN DISP "WaitinS to Connect" ! State=l. 
IF Line_state<>3 THEN Conn ! Wait for connection. 

DISP "Connected" ! Connection is now complete. 

SoftKey is set up so you can disconnect easily. 

SoftKey 1 sends a breaK to the remote computer. 

Most other Keys are trapped by the ON KBD interrupt service routine. 

ON KEY LABEL " Disconn" GOTO Disconnect ! Set up SoftKey 0, 
ON KEY 1 LABEL " BreaK" GOSUB BreaK ! Set up SoftKey 1. 

ON KBD GOSUB Keyboard ! Set up Keyboard interrupt. 

Now set UP the datacomm ON INTR serwice routine then enable interrupts 
for any data and/or Control BlocKs (see STATUS ReSister 4 definition). 

ON INTR Sc GOSUB Datacomm 

ENABLE INTR Soil 

Everythins is handled under interrupt. The bacKsround routine can be 
an idle loop doins nothins or a proSrani that runs when interrupts are 
not beins processed. 

BacKSround :GOTO BacKSround 

-->>>>>>>>>>>>>>> Datacomm Interrupt Service Routine <<<<<<<<<<<<<<<-- 
This emulator operates in character mode, handling only one character 
at a time. It is set up for no control blocKs in the receive sueue. 
and the dimension of A* limits inputs from datacomm to one character. 

The STATUS. ..4 acKncwledSes the interrupt from the card. Since only 
one interrupt condition is enabled, there is no reason to cheoK the 
value of STATUS ReSister 4. 

The ENABLE INTR allows the card to Generate another interrupt when it 
is ready. BASIC does not branch to the service routine until after 
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2010 
2020 
2030 
2040 
2050 
20B0 
2070 
2080 
2090 
2100 
2110 
2120 
2130 

ziao 

2150 
21 GO 
2170 
2180 
2190 
2200 
2210 
2220 
2230 
2240 
2250 
22B0 
2270 
22B0 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
23B0 
2370 
2380 
2390 
2400 
2410 
2420 
2430 
2440 
2450 
2460 
2470 
2480 
2490 
2500 
2510 
2520 
2530 
2540 
2550 
25G0 
2570 
2580 
2590 



the RETURN exit is completed. 

Since the datacomm interface can interrupt much faste 
seruicei exit from the routine occurs ONLY after ALL 
removed from the receive i u e u e . Since an interrupt c 
euen thouih the data has already been ENTERedi we mus 
Register 5 FIRST to see if any data is available. 



r than BASIC can 
data has been 
a 1 1 be Generated 
t check STATUS 



Datacomm:STATUS Sc .4il'iterrupt_bit5 

ENABLE INTR Sc 
Do: STATUS Sc t5 ;Rx_ay a i l_b i t s 

IF Rx_avail_bits=0 THEN RETURN 

ENTER So USING "» t-K" ;A$ 

PRINT USING "» tK" ;A* 

GOTO Dc 



A c K n ui 1 e d 3 e in 
Reenable inter 
Get data avail 
If empty) exit 
Get next data 
Print the char 
ChecK for more 



t e r r u p t by c a r d ( 
r M p t . 
able St 

s e r u i c 
b ■' t e . 
a c te r . 

■i a t a available. 



a t u 5 bits, 
e routine. 



This keyboard routine is not very exotic, but it CAN handle a fast 
typist. Some of the nested IF...THENs are used to decode the 255- 
and 255-255 notations for special and CONTROL- s pec i al keys. The only 
special Key allowed by this routine is ENTER (code is NUM("E")). It 
is converted to a c a r r i a 3 e - r e t u r n followed by a line t u r n - a r o u n d 
(iEND) indication. All ASCII Keys are transmitted to the card without 
alteration. 

The Keyboard routine loops until the Keyboard string has been 
completely serviced. Notice the similarities between the Keyboard and 
datacomm interrupt service routines. 



Keyboard :K$=KBD$ 



THEN RETURN 



IF NOT LEN(K*) 
Key=NUM(K*) 
K*=K*[23 
IF Key=255 THEN 
Key=NUM(K$) 
K»=K$[2] 
IF Key=255 THEN 
Key=NUM(K$) 
K*=K*[2] 
END IF 
IF Key=NUM( "E" ) THEN 

OUTPUT SciCHR$(13) 
ELSE 

BEEP 
END IF 
ELSE 

OUTPUT Sc ;CHR*(Key ) i 
END IF 
GOTO K 



END 



Stay 
Get 
St ri 
If n 
255 . 
St r i 
If 2 
9 
St ri 

f 
Chec 
Bend 
Ille 

f 



in r 
K e y 
p f i r 
ot 25 

Get 
p sec 
55 (C 
et th 
p thi 
r ENT 
k n n 

CR t 
3al c 
r n ex 



tine until K $ 
prefix (255= no 
character fro 
transmit char 
1 u e of next c h 
d character. 
TROD , 

d character u a 
character and 

SCI I to see if 
n turn line a r 
racter. Beep a 
character(s). 



is empty, 
n- ASCI I ) . 
m s t r i n 3 . 
ac t e r . 
a r ac t e r . 



1 ue . 
c h ec K 

ENTER. 
u n d . 
n d ret u r n 



ASCII Key 

compute r . 
End of character check 
Go set next Keystroke. 



Send it to the remote 



ro 
if 



u 1 1 n e . 
any . 



Key 1 sends a BREAK indication to the datacomm interface card. 



(reak:CONTROL Sc .G;1 
RETURN 



> Tell card to send a BREAK. 
! End of routine. 



Key disconnects the card and stops the prosram. 

Disconnect : CONTROL Sc.l2iO ! Disconnect Gracefully. 

DISP "Disconnected" 
END 
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If you have an HP 46020 keyboard, adjust the ON KEY statements to reflect available keys. 



1000 
1010 
1020 
1030 

loao 

1050 
lOBO 
1070 
1080 
1081 
1090 
1100 
1110 
1120 
1130 

uao 

1150 

HBO 

1170 

11 BO 

1190 

1200 

1210 

1220 

1230 

1240 

1250 

12B0 

1270 

1280 

1290 

1300 

1310 

1320 

1330 

13a0 

1350 

13G0 

1460 

1570 

1590 

IGOO 

1610 

1620 

1630 

1B40 

1B45 

1650 

1680 

1690 

1700 

1710 

1720 

1730 

1740 

1750 

17B0 

1770 

1780 

1790 

1800 

1810 

1820 

1830 

1B40 

1850 

1860 

1870 

1880 



******************** 
* 

* #*«**Exa 
* 

******************** 
» This sample term in 

* prosram structure 

* but contains the e 

* p ro s( rammin S techni 

* example for your c 
*#»#♦**»»♦»*»*#»*«»♦ 



♦«»**♦»#«♦ 



mpl e Data 



#«*»*♦ 
al emu 
of Sen 
s 5 e n t i 
q u e s . 
n ij e n i 
****** 



1 at 
e ral 

al e 

Lin 

en c e 

**** 



**************************************** 

* 
Link Terminal Emulator***** » 

« 
**»♦**#«♦***♦**«♦**♦#♦***»**«*##«*«*«**» 
r proSram is a simple example of the * 
-purpose emulators. It is not eleiantt* 
lements and illustrates commonly used * 
e numbers are matched to the Async * 
in comparing the two uersions. * 
♦#*♦*♦♦*»****♦»*«*#«♦#**»***»******♦*»*» 



Sc = 20 

DIM A$[1050] ,K*[100] 



! Select code of datacomm interface. 
#****#->-> A$ now handles 1000 characters. 



Reset datacomm interface and enable Async protocol. 



CONTROL So .Oil 
CONTROL Bo .3i2 
WaitiSTATUS So .38 i Al l_sen t 

IF NOT All-sent THEN Wait 
CONTROL So .Oil 



Reset card to disconnect from line. 

Select Data Link protocol. 

Wait until Control Block is sent to 

interface before resetting aSain. 
Reset card to start new protocol. 



Set UP datacomm options. Normally Just a few are included in the 
proSram. This Sroup overrides ALL defaults includinS switches. 

Set Control Block Mask for ETB/ETX. 

Set ON INTR mask for data in receiue quei 

Disable Connection timeout. 

Disable Lost Carrier timeout. 

Set Lost Carrier to 400 ms (default). 

Set Transmit Timeout=10 s (default). 

Set Line Speed to 9600 baud. 

Set GID character to "A" (default). 

Set DID character to "A". 

Hardware Handshake OFF for HP 132G4A. 

Set transmit block size to 512 (default) 

Parity not used with HP 1000 (default). 



CONTROL 


So 


.14 


6 


CONTROL 


Sc 


.15 





CONTROL 


So 


.16 





CONTROL 


Sc 


,17 





CONTROL 


Sc 


.18 


40 


CONTROL 


Sc 


.19 


10 


CONTROL 


Sc 


.20 


14 


CONTROL 


Be 


,21 


>1 


CONTROL 


Sc 


,22 


;i 


CONTROL 


Sc 


.23 


!0 


CONTROL 


Sc 


,24 


iO 


CONTROL 


Sc 


,3B 


iO 



Now we can initiate Start Connection. 



CONTROL Sc ,12il 



! Start the connection. 



If desired, this is the proper place to monitor STATUS Register 12 to 
see if the connection is actually made. 



DIBP "TryinS to connect" 
Conn:STATLIS Sc . 12 iLi n e_s t at e 

IF Line_state<>3 THEN Conn 
DISP "Connected" 



! Get Line State from STATUS Register. 

! Wait for connection. 

! Connection is now complete. 



SoftKey is set up so you can disconnect easily. 

Soft key sends a break to the remote computer. 

Most other keys are trapped by the ON KBD interrupt service routine. 



ON KEY LABEL " Disconn" GOTO Disconnect 
ON KEY LABEL " Break" GOSUB Break 
ON KBD GOSUB Keyboard 



! Bet UP Sof tkey . 

! Set UP Sof tkey . 

Set UP keyboard interrupt. 



Now set UP the datacomm ON INTR service routine then enable interrupts 
for anything received (see STATUS Resister 4 definition). *********** 

ON INTR Sc GOSUB Datacomm 

ENABLE INTR Soil 

EverythinS is handled under interrupt. The background routine can be 
an idle loop doinS nothinS or a program that runs when interrupts are 
not beinS processed. 

Back S round : GOTO BackSround 
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1890 
1300 
1310 
1920 
1330 
ISiJO 
1350 
19G0 
1370 
1980 
1390 
2000 
2 1 
2020 
2030 

2oao 

2 5 
2060 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
21ia0 
2150 
2160 
2170 
2180 
2130 
2200 
2210 
2220 
2240 
2250 
22G0 
2270 
2280 
2230 
2 30 
2310 
2320 
2330 
2340 
2350 
23G0 
2370 
2380 
2390 
2400 
2410 
2420 
2430 
2440 
2450 
2460 
24B5 
2470 
2480 
2430 
2500 
2510 
2520 
2530 
2540 
2550 
2560 
2570 
2580 
2530 



- > > >>>>>> D a t a c D fii m Interrupt Service Routine < < - - 

This emulator operates in blocK modet handlins inoomin3 data one block 

at a time. Entire data blocKs are read from the receiue queuet but 

the/ MUST be properly terminated by a Control Block. 

The STATUS. ..4 acknowledge 5 the interrupt from the card. Since only 
one interrupt condition is enabled, there is no reason i o check the 
ualue of STATUS Register 4. 

The ENABLE IIMTR allows the card to venerate another interrupt when it 
is ready. BASIC does not branch to the s e r u i c e routine until after 
the RETURN eKit is completed (i.e.. the routirie does not call itself). 

Since the datacomm interface can interrupt much faster than BASIC can 
serMicei exit from the routine occurs ONLY after ALL data has been 
r e rn M e d from the r e c e i u e queue. Since an interrupt can be Generated 
eiien thoush the data has already been ENTERed. we must check STATUS 
Resister 5 FIRST to see if any data is available. 



Datacomm: STATUS 5c t4i Interrupt- bits 

ENABLE INTR Sc 
Dc: STATUS Sc .5 ;Rx_a v a i I _b i t s 

IF Rx_avail_bits;:2 THEN RETURN 

ENTER Sc USING "« ,-K" iA$ 

PRINT USING "« .K" ;A$ 

GOTO Dc 



! Acknowledge interrupt by card. 

! R e e n a b I e interrupt. 

! Get data available status bits. 
!***#If no control block, exit. 

! Get next data byte. 

! Print the i n c o m i ri S block. 

! Check for more data available. 



This keyboard routine is not very exotic, but it CAN handle a fast 
typist. Some of the nested IF...THENs are used to decode the 255- 
and 255-255 notations for special and CONTROL- s pec i a 1 keys. The only 
special key allowed by this routine is ENTER (code is NUM("E"). It 
is converted to an end-of-block (SEND) indication. All ASCII keys are 
are transmitted to the card without alteration. 



The keyboard routine loops until the keyboard strins has been 
completely serviced. Notice the similarities between the keyboard 
datacomm interrupt service routines. 



a n d 



Keyboard :K$-KBD$ 

K: IF NOT LEN(h*) THEN RETURN 
Key=NUM(K$) 
k*=K$[2] 
IF Key=255 THEN 
Ke>' = NUM(K*) 
K$=K$[2] 
IF Key=255 THEN 
Key=NUM(K$) 
K*=K*[2] 
END IF 
IF Key=NUM("E") THEN 

OUTPUT sc;end 
ELSE 

BEEP 
END IF 
ELSE 

OUTPUT Sc iCHR$(Key ) i 
PRINT USING "« ,A" iCHR$(Key) 
END IF 
GOTO K 



Stay 
Get 
St ri 
If n 
255. 
St ri 
If 2 
i 
St ri 

f 
Chec 
Send 
lUe 

f 



1 n 
key 
p fi 
ot 2 

Get 
p s e 
55 ( 
et t 
p t h 
r EN 
k no 

e n d 
dal 
r n e 



rout 

r p 
rst 
55 , 

u a I 
c n d 
CONT 
h i rd 

1 rd 
TER. 
n-AS 
-of- 
c h a r 
X t c 



1 n e u n 
re f i X 
c h a r ac 
t r a n s III 
u e of 

ch a ra 
ROD . 

ch a ra 
ch a rac 

CII to 
block, 
ac t e r . 
ha rac t 



t l1 k$ 
(255=no 
t e r fro 
it char 
next c h 
c t e r . 

c l e r V a 

t e r and 

■see if 

Beep a 
e r ( s ) . 



IS empty. 
n-ASCII ) , 
m s t r i n 3 I 
ac t e r . 
a rac t e r . 



1 u e . 
check 



ENTER, 
n d return 



Send it to the remote 



ASCII Key. 
compute r . 
! Print character not echoed by DL. 
End of character check routine. 
Go Set next keystroke* if any. 



Key 1 sends a BREAK indication to the datacomm interface card. 



Break :CONTROL Sc .SU 
RETURN 



! Tell card to send a BREAK. 
! End of routine. 



Key disconnects the card and stops the program. 

Disconnect :C0NTRDL Scil2!0 \ Disconnect Sracefully. 

D I S P "Disconnected" 
END 
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Datacomm Programming Helps 

This sectioTi is designed to assist you in writing datacomm programs for special applications by 
discussing selected techniques and characteristics that can present obstacles to the beginning 
programmer. 

Terminal Prompt Messages 

Care must be exercised to ensure that messages are never transmitted to the network host if the 
host is not prepared to properly handle the message. Receipt of a poll from the host does not 
necessarily mean that the host can handle the message properly when it is received. Therefore, 
prompts or interpretation of messages from the host are used to determine the status of the host 
operating system. 

Prompts are message strings sent to the terminal by a cooperating program. They are well- 
defined and predictable, and are usually tailored to specific applications. When the terminal 
interacts directly with RTE or one or more subsystems, the process becomes less straightfor- 
ward. Each subsystem usually has its own prompt which is not identical to other subsystem 
prompts. To maintain orderly communication with subsystems, you must interpret each mes- 
sage string from the host to determine whether it is to be treated as a prompt. 

Prevention of Data Loss on the HP 1000 

On the HP 1000, the RTE Operating System manages information transfer between programs 
or subsystems and system I/O devices, including DSN/DL. Terminals are continually polled by 
the host's data link interface (unless auto-poll has been disabled by use of an HP 1000 File 
Manager CN command). Since there is no relationship between automatic polling and HP 1000 
program and subsystems execution, it is possible to poll a terminal when there is no need for 
information from that terminal. If the terminal sends a message in response to a poll when no 
data is being requested, the HP 1000 discards the message, causing the data to be lost, and 
treats it as an asynchronous interrupt. A break-mode prompt is then sent to the terminal by the 
host. 

The terminal must determine that the host is ready to receive a message in order to ensure that 
messages are properly handled by the host. This is done by checking all messages from the host 
( ENTER until queue is empty) and not transmitting (OUTPUT) until a prompt message or its 
equivalent has been received (unless you want to enter break-mode operation). Since the HP 
1000 does not generate a consistent prompt message for all programs and subsystems, it is 
easiest to use cooperating programs to generate a predictable prompt. If your application 
requires interaction with other subsystems, prompts can usually be most easily identified by the 
ABSENCE: of the sequence: '=r'-f^c_ at the end of a message. When a proper sequence has 
been identified, you are reasonably certain that the host is ready for your next message block. 
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Here is an example of host messages where a prompt is sent by the File Manager (FMGR) and 
answered by a RUN,EDITR command. Note that the prompt from the interactive editor fits the 
description of a prompt because a line-feed is not Included after the carriage-return in the 
sequence. 

: '^c- Prompt is sent by FMGR to terminal. 

R U J E D I T R EDITR Run command is sent to host. 

SOURCE FILE NAME?^r'-f^c_ File name message is sent by the host, followed by a 
^r/^l^c. prompt sequence which has no line-feed. Sequence is 

different from FMGR prompt. 

Whenever an unexpected message from a terminal is received by RTE, it is treated as an 
asynchronous interrupt which terminates normal communication with that terminal. A break- 
mode prompt is sent to the terminal by RTE, and the next message is expected to be a valid 
break-mode command. If the the message is not a valid command (such as data in a file being 
transferred), the data is discarded, and an error message is sent to the terminal. If, in the 
meantime, the cooperating program or subsystem generates an input request, the next data 
block is sent to the proper destination, but is out of sequence because at least one block has 
been lost. You can prevent such data losses and the mass confusion that usually ensues 
(especially during high-speed file transfers to the host), by disabling auto-poll on the HP 1000 
data link interface. With auto-poll OFF, no polls are sent to your terminal unless the host is 
prepared to receive data. 

Disabling Auto-poll on the HP 1000 

To operate with auto-poll OFF, log on to the network host, disable auto-poll, perform all 
datacomm activities and file transfers, enable auto-poll, then log off. If you don't enable 
auto-poll at the end of a session, polling is suspended to your terminal after log-off, and 
you cannot reestablish communication with the host unless polling is restored from 
another terminal or the network host System Console. 

The auto-poll ON/OFF commands are: 

C N » LU# . 2 3 B » 1 i 4 1 B Auto-poll OFF' 

C N » LU# , 2 3 B f 1 a 1 B Auto-poll ON' 

where LU# is the logical unit number assigned to your terminal. 

When auto-poll is disabled, no polls are sent to your terminal unless an input request is initiated 
by the cooperating program or subsystem on the network host. When the request is made, a 
poll is scheduled, and polling continues until a reply is received from the terminal. When the 
reply is received, and acknowledged, polling is suspended until the next input is scheduled. 
Operating with auto-poll OFF is especially useful when transferring files TO the HP 1000. 
Otherwise, in most applications, it is practical to leave auto-poll ON. 



1 Thy File Manager CN (Control) command parameters for the multipoint interface are described in more detail m the 91730A Multipoint 
Terminal Interface Subsystem User's Guide 
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Prevention of Data Loss on the HP 3000 

Neither the HP 1000 nor the HP 3000 provide a DCl poll character when they are ready for 
data inputs from DSN/DL. The HP 3000, like the HP 1000, also discards data if it has not 
requested the transfer. Since the HP 3000 does not provide an auto-poll disable command, 
you must interpret messages from the HP 3000 to determine that it is ready for the next data 
block before you transmit the block. 

Secondary Channel, Half-duplex Communication 

Half-duplex telecommunications links frequently use secondary channel communication to 
control data transmission and provide for proper line turn-around. This is done by using 
Secondary Request-to-send (SRTS) and Secondary Data Carrier Detect (SDCD) modem sig- 
nals. 

Consider tA'o devices communicating with each other: Each connects to the datacomm link, 
then waits for SDCD to become active (true). As each device connects to the line, Secondary 
Request-to-send is enabled, causing each modem to activate its secondary carrier output. The 
Secondary Data Carrier Detect is, in turn, activated by each modem as it receives the secondary 
data carrier from the other end. 

When communication begins, the first device to transmit (assumed to be your computer, in this 
case) clears its Secondary Request-to-send modem line. This removes the secondary data 
carrier from the line, causing the other modem to clear SDCD to its terminal or computer, 
telling it that you have the line. (The modems also 'maintain proper line switching and prevent 
timing conflicts so both ends don't try to get the line simultaneously.) The other device receives 
data, and must not attempt to transmit until you relinquish control of the line as indicated by 
SDCD true. After you finish transmitting, you must again activate SRTS so that SDCD can be 
activated to the other device, allowing it to use the line if it has a message. 

The following example is a simple terminal emulator that uses secondary channel communica- 
tion to control data flow on a half-duplex link: 

1000 ! im********** ************************************ *********************** 

1010 ! ♦ * 

1020 ! * HALF-DUPLEX TERMINAL EMULATOR FOR SECONDARY CHANNEL OPERATION * 

1030 ! * * 

lOaO ! * This proSram uses secondary channel modem lines to indicate which * 

1050 ! » end is in control of the line. BASIC is used to assemble data * 

lOBO ! » for transmission to the other end. This example is compatible » 

1070 ! * with the Option 001 (male) cable only. * 

1080 ! ♦ * 

1090 ! *********************************************************************** 

1100 ! 

1110 Sc=20 ! Select code of HP 98B2B datacomm interface. 

1120 DIM A*Cn.K*[1003 ! Size of datacomm and Keyboard strinSs. 

1130 ! 

1140 ! Reset the card to disconnect) then select Async protocol. 

1150 ! 

IIGO CONTROL Sc .Oil 

1170 CONTROL Sc ,3!1 

1180 Wait: STATUS Sc .38 i A 1 1 _5 en t 

1190 IF NOT All_sent THEN Wait 

1200 CONTROL Sc .Oi 1 

1210 ! 

1220 ! Set UP all the interface configuration options for Async protocol. 
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1230 

i2ao 

12 50 
1255 
12B0 
1270 
1280 
1290 
1300 
1310 
132 
1330 
13^10 
1350 
13G0 
1370 
1380 
1390 

laoo 

1410 
14 20 
1430 
1440 
1450 
14G0 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
15G0 
1570 
1580 
1590 
IBOO 
IBIO 
1G20 
1G30 
1640 
1650 
1B60 
1G70 
1B80 
1G90 

17 00 
1710 
1720 
1730 
1740 
1750 
17G0 
1770 
1780 
1790 
1 B 
1810 
1820 
1830 

18 40 
1850 
18G0 
1870 
1880 
1890 
1900 



CONTROL Sc 
CONTROL Sc 

CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 



.14 


!0 


.15 


; IG 


.IB 


;o 


.17 


;o 


.18 


5 40 


.13 


!10 


,20 


;7 .7 


* ^L. 


iO 


.23 


2 


.24 


255 


.28 


2,13,10 


.31 


1 ,17 


,34 


^ 


,35 





.3B 


1 


,37 





.39 


4 



Set Coritrol BlocK masK off. 

Interrupt when Secondary C a r r i i? r Detect 

modem line c h a n j e s state. 
Disable connection timeout. 
Disable No A c t i u i t v timeout. 
Lost Carrier 400 ms (default). 
Transmit timeout 10 s (default). 
Line speed; 300 baud in both directions. 
Disable protocol handshake. 
Half duplex modem connection. 
Do not remoue protocol characters. 
EOL sequence CR/LF (default). 
Prompt DCl (default ) , 
7 bits per character. 
1 . s t p bit. 
odd parity, 

No i n-t e r- c ha rac te r Sap (default). 
Set BreaK tc 4 character times (default). 



! Initiate connection to the telecommunications line. 
! 

CONTROL Sc .iz;i 
! 

! Tell the operator what is happening, then wait for connection to finish. 
I 

D I S P "Waiting to connect" 
Conn: STATUS Sc . 1 2 ! L i n e_s t at e 

IF Line_state=l THEN Conn 

DISP "Naitins for SDCD to become active" 

Get the SDCD handshake started properly by waiting for the other end to 
relinquish control of the line by actiuatinS SDCD, 

Statck: STATUS So .7;Modem.lines 

IF NOT BINAND(Modem_lines .IB) THEN Statck 
DISP "Connected" 

! 

! Set UP a key to s r a c e f u 1 1 y disconnect the datacomm connection. 
! 

ON KEY LABEL " Disconn" GOTO Disconnect 
I 

! Interrupt en data receiwed or modem line change (change in SDCD). 
! 

ON INTR Sc GOSUB Datacomm 
ENABLE INTR Sc ;i+8 

Send a "READY" messaSe to the remote to Set thmSs started, This is 
optional , 

CONTROL Sc,8;7 ! Put down SRTS 
OUTPUT Sc i" READY" !CHR$( 13) SEND 
CONTROL Sc,8;i5 ! Put up SRTS 

The background idle loop simply waits for interrupts to happen. 

BacKsround: GOTO Backsrcunj 

************************ **^^****^^***^h**1^1Hi■*^^**^^**^nnn■^nn^^nnnnmnt^n.^^ 
DATACOMM INTERRUPT SEROICE ROUTINE 

First, acknowledge interrupt by readinS STATUS resister 4. 

Read all existing data in the buffer. 

When SDCD becomes true, it indicates that the remote is through 

t ransmi t t in S . A LINPUT statement is prouided to let the user enter a 

line of data. The line is then sent to both the screen and the 

datacomm card. To maintain control of the line, we disable SRTS (Control 
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1910 
1920 
1930 
1940 
1950 
19S0 
1970 
1980 
1990 
2000 
2010 
20Z0 
2030 
2040 
2050 
ZOGO 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
21 GO 



ReSister 8)i then reactivate it when we are throush send in S. 

Finally) re-enable interrupts and exit the interrupt routine. 

Datacodim: STATUS Sc .ailnterrupt-bits 
Read: STATUS Sc »5 i Rx_ai.>ai l_b i t s 

IF Rx_aijail_bi t5 = THEN Chkmdm 
ENTER So USING "« .-K" !A$ 
PRINT USING "« .K" iA$ 
GOTO Read 
ChKmdm: STATUS So )7 iMod Bm_ 1 in e s 

IF BINAND(Modem_Iines .IB) THEN 

CONTROL Sc.8i7 ! Put down SRTS 
LINPUT "Line to send.,.?".K$ 
PRINT K* 

OUTPUT Sc ;K$!CHR$( 13) iEND 
CONTROL So.8il5 ! Put up SRTS 
END IF 

ENABLE INTR So 
RETURN 
»#*♦*♦#♦♦♦*»*#♦*»#»#*♦*•***#♦♦♦*♦♦***♦*♦♦*♦♦*♦*»»♦♦♦**♦»*»**♦ 
Key was set up to disconnect from the datacomm line. 

Disconnect sCDNTROL Sc.l2i0 
DISP "Disconnected" 
END 



Automatic Answering Applications 

Desktop computers are sometimes used in applications where they may have to be able to 
automatically answer incoming calls from other computers by means of public (switched) 
telephone lines. For instance, a desktop computer may be located at an unattended remote site 
in a data gathering network where the network host computer periodically calls the remote site 
for data updates. In other situations, the desktop computer may be the host for several compu- 
ters or terminals that originate the calls. Other applications may require that two (or more) 
desktop computers be able to call each other in either direction at will. 

In automatic answering applications, the Ring Indicator (RI) modem line is used by the desktop 
computer to recognize incoming calls from the host. This enables the desktop computer to 
answer the call by connecting to the datacomm line. Usually, a continuously running program 
on the unattended computer contains an ON INTR statement set up to monitor the Rl modem 
signal. When RI is activated by the incoming call, normal program flow is interrupted, and the 
connection is initiated. The desktop computer then sets up the necessary datacomm and other 
program interrupts, and proceeds to the program segment responsible for transferring data to 
the remote computer. The following example illustrates the general technique and how it fits 
into overall program structure: 



1000 
1010 
1020 
1030 
1040 
1050 
lOGO 
1070 
1080 
1090 
1100 
1110 
1120 ! 



♦ * 

♦ TERMINAL EMULATOR WITH AUTOMATIC ANSWERING CAPABILITY * 

♦ * 

♦ This proSram waits for the rinS-indicator modem line to ohanSe ♦ 

♦ {indicating an incominS datacomm call)i then connects to the # 
» datacomm line. Use with Option 001 (male) modem cable. # 
« ♦ 

Sc=20 ! Select code of HP 38G28 datacomm interface. 

DIM A$[ 1 ] (K$C 100] ! Size of datacomm and Keyboard strinSs. 
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1 130 

iiao 

I 150 

II BO 
1 170 
1180 
1 190 
1 2 
1210 
1220 
1230 

i2ao 

1250 
1260 

12 70 
1280 
1290 
1300 
1310 
1320 
1330 
13^0 

13 50 
13G0 
13 70 
1380 
1390 
1400 
1410 
1420 
1430 
1440 
1450 
14B0 
1470 
1480 
1490 
1500 
1510 
1520 
1530 
1540 
1550 
1580 
15 70 
1580 
1590 
1600 
1610 
1620 
1630 
1640 

165 

166 
1G70 
1680 
1680 
1700 
1710 
1720 
1730 
1740 
1750 
1780 
1770 
1780 
1790 
18 00 
1810 



! Reset the card to disco nnectt then select As'/nc protocol. 



CONTROL So 
CONTROL Sc 
Wait : STATUS So . 
IF NOT All 
CONTROL Sc 

Set UP all the 

CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 
CONTROL So 
CONTROL Sc 
CONTROL So 
CONTROL Sc 
CONTROL Sc 
CONTROL Sc 



o; 1 
3;i 

8 ; A 11 _ s e n t 

sent THEN Wait ^ 

o;i 

n t e r f a c e c o n f i S u r a t i o n options for A s y n c protocol. 



Set Control B 1 o c K m a s K off. 

Interrupt when Rins Indicator line chanses. 

Disable connection timeout. 

Disable No A c t i u i t >■ timeout. 

Lost Carrier 400 ms (default). 

Transmit timeout 10 s ( d e f a u 1 1 J . 

Line speed: 300 baud in both directions. 

Disable protocol handshaKe. 

Full duplex modem connection. 

Re mo Me no protocol characters. 

EOL sequence CR/LF (default). 

Prompt DCl (default ) . 

7 bits per character. 

1 stop bit. 

Odd parity. 

No inter-character 9ap (default). 

Set BreaK to 4 character times (default). 



14 





15 


8 


16 





17 





18 


40 


19 


10 


20 


7 ,7 


22 





23 


1 


24 


255 


28 


2.13,10 


31 


1 .17 


34 


2 


35 





3E 


1 


37 





39 


4 



Wait for R i n s Indicator modem line to c h a n S e . 

ON INTR Sc GOTO Runt 

ENABLE INTR Sc i8 

D I S P " W a i t i n 3 for r i n S to come in" 
Waitri:GOTO Waitri 
I 

! When interrupt occurs, i n 1 1 i a t e connection to the datacomm line. 

! 

Ri_int :CONTROL Sc ,12 il 
I 

! Tell the operator what is happen in s, then wait for connection to finish. 
! 

D I S P " W a i t i n S to connect" 
Conn: STATUS Sc , 12 ! L i n e_s t at e 

IF Line_-5tate = l THEN Conn 
D I S P "Connected" 

Set UP key to Gracefully disconnect from the datacomm line, then 
set up Key 1 to send a b r e a K . 

ON KEY LABEL " Disconn" GOTO Disconnect 
ON KEY 1 LABEL " BreaK" GOSUB BreaK 

Interrupt on data r e c e i u e d . Also set up Keyboard interrupts. 

ON INTR Sc GOSUB Datacomm 

ENABLE INTR Sc ;i 

ON KBD GOSUB Keyboard 

The b a c K s r u n d idle loop simply waits for interrupts to happen. 

BacKsround: GOTO BacKSround 

********************************************************************** 
DATACOMM INTERRUPT SERUICE ROUTINE 

First, acKnowledSe interrupt by readinS STATUS resister 4. 

Re-enable interrupts, then read all existing data in the b u f f e r . 

When the buffer is empty, exit the service routine. 
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1820 
1830 
1840 
1B50 
IBGO 
1B70 
IBSO 
1B90 
1900 
1310 
1920 
1930 
1940 
1950 
19G0 
1970 
1980 
1990 
2000 
2010 
2020 
2030 
2040 
2050 
20G0 
2070 
2080 
2090 
2100 
2110 
2120 
2130 
2140 
2150 
21 BO 
2170 
21 BO 
2190 
2200 
2210 
2220 
2230 
2240 
2250 



Datacomm; STATUS Sc »4ilnterrupt_bits 

ENABLE INTR Sc 
Read: STATUS Sc i5 ! Rx_auai 1 _b i t s 

IF Rx-auail_bits=0 THEN RETURN 
ENTER Sc USING " » ,-K" JA* 
PRINT USING "»iK" iA* 
GOTO Read 
♦ *»#»*#»**♦#*»♦*♦»»♦#**•»*#♦♦*♦#*♦#*♦*♦♦#♦***»♦*♦#»*♦**»**♦*»•»#**»»# 
This keyboard interrupt seruice routine is similar to the other 
examples in this chapter. It sends ASCII Keys to the remotei and 
accepts ENTER as a Ca r ri aSe-Re t u rn . Other Kevs cause a BEEP. 



! Repeat until K$ is empty 
! Get Key or prefix 



! If prefixf Set next character 

! If control-Key prefixt Set 
! the third character 



Keyboard :K* = KBD* 

K: IF NOT LEN(K$) THEN RETURN 
Key=NUM(K$) 
K$=K*[2] 
IF Key=255 THEN 
Key=NUM(K*) 
K$=K$C2] 
IF Key=255 THEN 
Key=NUM(K$) 
K*=K*C2] 
END IF 
IF Key=NUM("E") THEN ! ChecK for ENTER Key 

OUTPUT Sc iCHR$( 13) iEND ! If so. send oarriaSe return 
ELSE 

BEEP 
END IF 
ELSE 

OUTPUT Sc ;CHR*(Key ) i ! ASCII Key: Just send it 
END IF 

GOTO K ! Repeat until K* is empty 

«*»♦♦»*»♦*♦♦*♦#♦#**•»♦*♦♦•»♦*♦♦■»##♦»♦«♦*♦*«*#****♦**♦**»*#♦***»**»#»•»# 
Key 1 was set up to send a breaK. 

BreaK: CONTROL Sc .Bi 1 
RETURN 

Key was set up to disconnect the interface from the datacomm line. 

Disconnect iCONTRQL Sctl2i0 
DISP "Disconnected" 
END 



Commuinication Between Desktop Computers 

Two desktop computers can be connected, directly, or by use of modems. DC1/DC3 hand- 
shake protocol can be used conveniently to enable each computer to transmit at will without 
risk of buffer or queue overruns. To ensure proper operation, the following guidelines apply: 



• Set up Control Register 22 with a value of 5. This allows both computers to act either as 
host or terminal in any given situation, depending on which one initiates the action. 

• Set up Control Registers 26 and 27 for DCl and DC3 respectively, or use two other 
characters if necessary. 

• Data to be transmitted must NOT contain any characters matching the contents of Control 
Register 26 or 27. This prevents the receiving interface from confusing data with control 
characters. 

• If both computers attempt to transmit large amounts of data at the same time, a lock-up 
condition may result where each side is waiting for the other to empty its buffers. 
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Cable and Adapter Options and Functions 

The HP 98628A Datacomm Interface is available with RS-232C DTE and DCE cable configura- 
tions, or it can be connected to various modems or adapters for other applications. 

DTE and DCE Cable Options 

DTE and DCE cable options are designed to simplify connecting two desktop computers 
without the use of modems. The DTE cable (male RS-232 connector) is configured to make the 
datacomm interface look like standard data terminal equipment when it is connected to an 
RS-232C modem. The DCE cable (female RS-232 connector) is configured so that it eliminates 
the need for modems in a direct connection. When you connect two computers to each other in 
a direct non-modem connection, both datacomm interfaces are functionally identical. The DCE 
cable acts as an adapter so that both interfaces behave exactly as they would if they were 
connected to a pair of modems by means of DTE cables. 

Several signal lines are rerouted in the DCE cable so that, in direct connections, outputs from 
one interface are connected to the corresponding inputs on the other interface. Certain outputs 
on each interface are also connected to inputs on the same card by "loop-back" connections in 
the DCE cable. 

The schematic diagram in this section shows two datacomm interfaces directly connected 
through a DTE-DCE cable pair. Note that the DCE cable wiring complements the DTE cable so 
that output signals are properly routed to their respective destinations. Signal names at the 
RS-232C connector interface are the same as the signal names for the DTE interface. However, 
because the DCE cable adapts signal paths, the signal name at the RS-232C connector does 
not necessarily match the signal name at the DCE interface. Connector pin numbers are 
included in the diagram for your convenience. 

RS-232C DTE (male) Cable Signal Identification Tables 



Signal 


Interface 


RS-232C 








RS-232C 


V.24 


Pin# 


Pin# 


Mnemonic 


I/O 


Function 


AA 


101 


24 


1 


— 


— 


Safety Ground 


BA 


103 


12 


2 




Out 


Transmitted Data 


BB 


104 


42 


3 




In 


Received Data 


CA 


105 


13 


4 


RTS 


Out 


Request to Send 


CB 


108 


44 


5 


CTS 


In 


Clear to Send 


CC 


107 


45 


6 


DSR 


In 


Data Set Ready 


AB 


102 


48 


7 


- 


- 


Signal Ground 


CF 


109 


46 


8 


DCD 


In 


Data Carrier Detect 


SCF (0CR2) 


122 


47 


12 


SDCD 


In 


Secondary DCD 


DB 


114 


41 


15 




In 


DCE Transmit Timing 


DD 


115 


43 


17 




In 


DCE Receive Timing 


SCA (OCD2) 


120 


15 


19 


SRTS 


Out 


Secondary RTS 


CD 


108.1 


14 


20 


DTR 


Out 


Data Terminal Ready 


CE(OCRl) 


125 


9 


22 


Rl 


In 


Ring Indicator 


CH (OCDl) 


111 


40 


23 


DRS 


Out 


Data Rate Select 


DA 


113 


7 


24 




Out 


Terminal Transmit Timing 
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Optional Circuit Driver/Receiver Functions 

Two optional drivers and receivers are used with the RS-232C cable options. Their functions 
are as follows: 



Name 



OCDl 
OCD2 
0CD3 
0CD4 



Drivers 
Function 



Receivers 



Name 



Data Rate Select 
Secondary Request-to-send 
Not used 
Not used 



OCRl 
OCR2 



Function 



Ring Indicator 

Secondary Data Carrier Detect 



0CD2 is used for autodial pulsing in the HP 13265A Modem. None of the optional 
drivers and receivers are used for Data Link and Current Loop Adapters. 



98628 
INTERFACE *! 

DATA 



DTE 
CABLE 



-< 
^> 



OUT 
DATA 



-«^ 



IN 
RTS 



-<^ 



42 



<^ 



CTS 



■«^ 



DCD 



«: 



46 






SECONDARY . .15 
RTS ^* 

SECONDARY . .47 
^DCD ^^ 

DTP 



-«^ 



__-/lDSR 



^^ 



«r 



45 



rXMIT TIMING 

DCE 

RCV. TIMING 



^<= 



<4 



43 



SIGNAL 
GROUND. 



-'i 



-«: 



48 






SAFETY I— 
GROUND^ 



-<f 



24 



DTE 



XMIT TIMING" 
DRS 



«^ 



«r 



40 



RS-232C 
SIGNALS 

-> BA(PIN 2) >- 



-> BB(PIN 3) >- 



->CA(PIN4) >- 
■^ CB(PIN 5) >- 



->CF(PIN8) >- 



->SCA{PINI9)>- 



->SCF(PINI2)>- 



-^ CD(PIN20)>- 



■^CE(PIN22)>- 



-> CCtPIN 6) >- 



->DB(PINI5) >- 



->DD(PINI7) >- 



-> AB(PIN 7) >- 



-^AA(PIN I) >- 
-^ DA (PIN 24) >- 



DCE 
CABLE 



42 



»- 



98628 
INTERFACE "2 

DATA 



^>- 



IN 
DATA 



46 



»- 



OUT 
DCD 



{> 



t>- 



i»- 



RTS 



44 



»- 



CTS 



47,, SECONDARY 
'' DCD 

l5v,SEC0NDARY 
*^ RTf 






^^ 



45 



>>- 



^>- 



dsrJ\___ 



^^ 



DCE 



RCV TIMING 



^>: 



DCE 



XMIT TIMING 






48. 



»- 



24 



-|SI 



SIGNAL 
ROUND 



»- 



■NOT USED 
> CH (PIN 23) > NOT USED 

1 ! ! 

INTERFACE MALE FEMALE INTERFACE 
REAR PANEL RS-232C RS-232C REAR PANEL 
CONNECTOR CONNECTOR CONNECTOR CONNECTOR 



— I SAFETY 
^GROUND 



DTE/DCE Interface Cable Wiring 
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RS-232C/CCITTV241 

The following table provides information about each data communications interface func- 
tion. The pin assignments are also shown. Not all of the functions provided by RS-232C are 
implemented. The functions denoted with an * are implemented. 

RS-232C/CCITTV24' 



RS-232C 


CCITT V24 


Signal Name 


*Pinl 


101 


PROTECTIVE GROUND. Electrical equipment frame and ac power 
ground. 


*Pin2 


103 


TRANSMIIIED DATA. Data originated by the terminal to be 
transmitted via the sending modem. 


*Pin3 


104 


RECEIVED DATA. Data from the receiving modem in response to 
analog signals transmitted from the sending modem. 


*Pin4 


105 


REQUEST TO SEND. Indicates to the sending modem that the 
terminal is ready to transmit data. 


*Pin5 


106 


CLEAR TO SEND. Indicates to the terminal that its modem is ready 
to transmit data. 


*Pin6 


107 


DATA SET READY. Indicates to the terminal that its modem is not 
in a test mode and that modem power is ON. 


Tin 7 


102 


SIGNAL GROUND. Establishes common reference between the 
modem and the terminal. 


*Pin8 


109 


DATA CARRIER DETECT. Indicates to the terminal that its 
modem is receiving carrier signals from the sending modem. 


Pin 9 




Reserved for test. 


Pin 10 




Reserved for test. 


Pin 11 




Unassigned. 


*Pin 12 


122 


SECONDARY DATA CARRIER DETECT. Indicates to the terminal 
that its modem is receiving secondary carrier signals from the send- 
ing modem. 


Pin 13 


121 


SECONDARY CLEAR TO SEND. Indicates to the terminal that its 
modem is ready to transmit signals via the secondary channel. 



These signals are commonly used for 3 wire (no modem) links. 



1 International Telephone and Telegraph Consultative Committee European standard. 
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RS-232C/CCITTV24 (Cont'd) 



RS-232C 


CCITT V24 


Signal Name 


Pin 14 


118 


SECONDARY TRANSMITTED DATA. Data from the terminal to 
be transmitted by the sending modem's channel. 


*Pin 15 


114 


TRANSMITTER SIGNAL ELEMENT TIMING. Signal from the 
modem to the transmitting terminal to provide signal element timing 
information. 


Pin 16 


119 


SECONDARY RECEIVED DATA. Data from the modem's secon- 
dary channel in response to analog signals transmitted from the 
sending modem. 


*Pin 17 


115 


RECEIVER SIGNAL ELEMENT TIMING. Signal to the receiving 
terminal to provide signal element timing information. 


Pin 18 




Unassigned. 


*Pin 19 


120 


SECONDARY REQUEST TO SEND. Indicates to the modem that 
the sending terminal is ready to transmit data via the secondary 
channel. 


*Pin 20 


108.2 


DATA TERMINAL READY. Indicates to the modem that the as- 
sociated terminal is ready to receive and transmit data. 


Pin 21 


110 


SIGNAL QUALITY DETECTOR. Signal from the modem telling 
whether a defined error rate in the received data has been exceeded. 


*Pin 22 


125 


RING INDICATOR. Signal from the modem indicating that a ring- 
ing signal is being received over the line. 


*Pin 23 


111 


DATA SIGNAL RATE SELECTOR. Selects one of two signaling 
rates in modems having two rates. 


*Pin 24 


113 


TRANSMIT SIGNAL ELEMENT TIMING. Transmit clock provided 
by the terminal. 


Pin 25 




Unassigned. 
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Summary of Datacomm 
Status and Control Registers 

Unless indicated otherwise, the Status Register returns the current value for a given parameter: 
the Control Register sets a new value. 



Register 




Function 




1 (Status 

2 (Status 


only) 
only) 


Control: Interface Reset: Status: Interface Card ID 

Hardware Interrupt Status: 1 = Enabled, = Disabled 

Datacomm activity: = inactive, 1 = ENTER in process, 2 = OUTPUT in process 


3 

4 (Status 

5 


only) 


Select Protocol: 1 = Async, 2 = Data Link 

Cause of ON INTR program branch 

Control: Terminate transmission: Status: Inbound queue status 


6 

7 (Status 
8 


only) 


Control: Send BREAK to remote: Status: 1 = BREAK pending 
Current modem receiver line states 
Modem driver line states 


9 (Status 

10 (Status 

11 (Status 


only) 
only) 
only) 


Control block TYPE 

Control block MODE 

Available outbound queue space 


12 
13 
14 




Control: Connect/Disconnect line; Status: Line connection status 
ON INTR mask 
Control Block mask 


15 
16 

17 




Modem Line interrupt mask 
Connection timeout limit 
No Activity timeout limit 


18 
19 




Lost Carrier timeout limit 
Transmit timeout limit 


20 




Async: Transmit baud rate (line speed) 

Data Link: Set Transmit/Receive baud rate (line speed) 


21 




Async: Incoming (receiver) baud rate (line speed) 

Data Link: GID address (0 thru 26 corresponds to "$j " thru "Z" ) 


22 




Async: Protocol handshake type 

Data Link: DID address (0 thru 26 corresponds to "(" " thru "Z" 1 


23 




Hardware handshake type: ON/OFF, HALF/FULL duplex, Modem/Non-modem 
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Register 



24 

25 (Status only) 

26 



Function 



Async: Control Character mask 

Data Link: Block Size limit 

Number of received errors since last interface reset 



Async: First protocol character (ACK/DCl) 

Data Link: NAKs received since last interface reset 
Registers 27-35, 37, and 39 are used with Async protocol only. They are not accessible 
during Data Link operation. 



27 
28 
29 

30 
31 
32 

33 
34 
35 

36 
37 

38 (Status only) 

39 



Second protocol handshake character (ENQ/DC3) 
Number of characters in End-of-line sequence 
First character in EOL sequence 

Second character in EOL sequence 
Number of characters in PROMPT sequence 
First character in PROMPT sequence 

Second character in PROMPT sequence 

Data bits per character excluding start, stop and parity 

Stop bits per character (0 = 1, 1 = 1.5, and 2 = 2 stop bits) 

Parity sense: = NONE, 1 = ODD, 2 = EVEN, 3 = ZERO, 4 = ONE 
Data Link: = NONE (HP 1000 host), 1 = ODD (HP 3000 host) 
Inter-character time gap in character times (Async only) 

Transmit queue status (1 = empty) 

BREAK time in character times (Async only) 
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HP 98628 Data Communications Interface 
Status and Control Registers 

General Notes: Control registers accept values in the range of zero through 255. Some regis- 
ters require specified values, as indicated. Illegal values or values less than 
zero or greater than 255, cause ERROR 327. 

Reset value, shown for various Control Registers, is the default value used by 
the interface after a reset or power-up until the value is overridden by a 
CONTROL statement. 

Status Card Identification 

Value returned: 52 (if 180 is returned, checl^ select code switch cluster and make sure 
switch R is ON). 

Control Card Reset 

Any value, 1 thru 255, resets the card. Immediate execution. Data in queues is destroyed. 

Status 1 Hardware Interrupt Status (not used in most applications) 
1 = Enabled = Disabled 

Status 2 Datacomm Activity 

= No activity pending on this select code. 
Bit set: ENTER in process. 

Bit 1 set: OUTPUT in process. 

(Non-zero ONLY during multi-line function calls.) 

Status 3 Current Protocol Identification: 

1 = Async, 2 = Data Lini< Protocol 

Control 3 Protocol to be used after next card reset ( control sc ,o n ) 
1 = Async Protocol 2 = Data Link Protocol 

This register overrides default switch configuration. 

Status 4 Cause of ON INTR program branch. 



Bit 


Function: Async Protocol 


Function: Data Link Protocol 





Data and/or Control Block available 


Data Block Available 


1 


Prompt received 


Space available for a new transmis- 
sion block 


2 


Framing and/or parity error 


Receive or transmit error 


3 


Modem line change 


Modem line change 


4 


No Activity timeout (forces a discon- 


No Activity timeout (forces a discon- 




nect) 


nect) 


5 


Lost carrier or connection timeout 


Lost carrier or connection timeout 




(forces a disconnect) 


(forces a disconnect) 


6 


End-of-line received 


Not Used 


7 


Break received 


Not Used 



Contents of this register are cleared when a STATUS statement is executed to it. 
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Status 5 Inbound queue status 



Value 




1 
2 
3 



Interpretation 



Queue is empty 

Queue contains data but no control blocks 

Queue contains one or more control blocks but no data 

Queue contains both data and one or more control blocks 



Control 5 Terminate Transmission 

OUTPUT S»550 is equivalent to OUTPUT Si END 

Data Link: Sends previous data as a single block with an ETX terminator, then idles the 
line with an EOT. 

Async: Tells card to turn half-duplex line around. Does nothing when line is full- 
duplex. The next data OUTPUT automatically regains control of the line by 
raising the RTS (request-to-send) modem line. 

Status 6 Break status: 1 = BREAK transmission pending, = no BREAK pending. 

Control 6 Send Break; causes a Break to be sent as follows: 

Data Link Protocol: Send Reverse Interrupt (RVI) reply to inbound block, or CN character 

instead of data in next outbound block. 
Async Protocol: Transmit Break. Length is defined by Control Register 39. 
Note that the value sent to the register is arbitrary. 

Status 7 Modem receiver line states (values shown are for male cable connector option for 
connection to modems). 

Bit 0: Data Mode (Data Set Ready) line 

Bit 1: Receive ready (Data Carrier Detect line) 

Bit 2: Clear-to-send (CTS) line 

Bit 3: Incoming call (Ring Indicator line) 

Bit 4: Depends on cable option or adapter used 

Status 8 Returns modem driver line states. 

Control 8 Sets modem driver line states (values shown are for male cable connector option 
for connection to modems). 

Bit 0: Request-to-send (RS or RTS) line 1 = line set (active) 

Bit 1: Data Terminal Ready (DTR) line = line clear (inactive) 

Bit 2: Driver 1: Data Rate Select 

Bit 3: Driver 2: Depends on cable option or adapter used 

Bit 4: Driver 3: Depends on cable option or adapter used 

Bit 5: Driver 4: Depends on cable option or adapter used 

Bits 6,7: Not used 

Reset value = prior to connect. Post-connect value is handshake dependent. 
Note that RTS line cannot be altered (except by OUTPUT or OUTPUT... END) for half- 
duplex modem connections. 
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Status 9 Returns control block TYPE if last ENTER terminated on a control block. See 
Status Register 10 for values. 

Status 10 Returns control block MODE if last ENTER terminated on a control block. 

Async Protocol Control Blocks 



Type 


Mode 


Interpretation 


250 


1 


Break received (Channel A) 


251 


1^ 


Framing error in the following character 


251 


2' 


Parity error in the following character 


251 


31 


Parity and framing errors in the following character 


252 


1 


End-of-line terminator detected 


253 


1 


Prompt received from remote 








No Control Block encountered 



Data Link Protocol Control Blocks 



Type 


Mode 


Interpretation 


254 
254 
253^ 




1 
2 




Preceding block terminated by ElB character 
Preceding block terminated by ETX character 
(see following table for Mode interpretation) 

No Control Block encountered. 



Mode Bit(s) 


Interpretation 





1 = Transparent data in following block 




= Normal data in following block 


2.1 


00 = Device select 




01 = Group select 




10 = Line select 


3 


1 = Command channel 




2 = Data channel 



Status 11 Returns available outbound queue space (in bytes), provided there is sufficient 
space for at least three control blocks. If not, value is zero. 



1 Parity/framing error control blocks are not generated when characters with parity and/or framing 
errors are replaced by an underscore (_) character. 

2 This type is used primarity in specialized applications. 
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Status 12 Datacomm Line connection status 



Value 


Interpretation 



1 
2 
3 
4 
5 
6 


Disconnected 

Attempting Connection 

Dialing 

Connected^ 

Suspended 

Currently receiving data (Data Link only) 

Currently transmitting data (Data Link only) 



Note 

When the datacomm line is suspended, CLEAR, ABORT, or RESET 
must be executed before the line can be reconnected. 

Reset value — if R on interface select code switch cluster is ON (1). 
Control 12 Connects, initiates auto-dial sequence, and disconnects interface from datacomm 
line. 



Value 



Interpretation 




1 
2 



Disconnect from datacomm line 

Connect to datacomm line (set DTR & RTS) 

Start auto dial. (Followed by OUTPUT of telephone numbers) 



Status 13 Returns current ON INTR mask 
Control 13 Sets ON INTR mask^ 

Data Link Protocol: 



Bit 


Value 


Enables interrupt when: 





1 


A full block is available in receive queue 


1 


2 


Transmit queue is empty 


2 


4 


Receive or transmit error detected 


3 


8 


A modem line changed 


4 


16^ 


No Activity timeout forced a disconnection 


5 


32^ 


Lost Carrier or Connection timeout caused a disconnection 



Async Protocol: 



Bit 


Value 


Enables interrupt when: 





1 


Data or control block available in receive queue 


1 


2 


Prompt received from remote device 


2 


4 


Framing or parity error detected in incoming data 


3 


8 


A modem line changed 


4 


16^ 


No Activity timeout forced a disconnection 


5 


32^ 


Lost Carrier or Connection timeout caused a disconnection 


6 


64 


End-of-line received 


7 


128 


Break received 



Reset value = 

1 When using Data Link; Connected - datacomm idle 

2 If a CONTROL statement is used to access this register, the control block is placed in the outbound queue. If the ENABLE INTR. . . statement i 
used with a mask, the mask value is placed directly in the control register, bypassing any queue delays. 

3 If bits 4 and 5 are not set, the corresponding errors can be trapped by using an ON ERROR statement. 
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Status 14 Returns current Control Block mask. 



Control 14 Sets Control Block mask. Control block information is queued sequentially with 
incoming data as follows: 



Bit 




1 
2 
3 



Value 



1 
2 

4 



Reset Value: 



Async Control Block Passed 



Prompt position 
End of-line position 
Framing and/or Parity error' 
Break received 

(Control Blocks disabled) 



Data Link Control Block Passed 



Transparent/Normal Mode' 
ETX Block Terminator'^ 
ETB Block Terminator'' 

6 (ETX/ETB Enabled) 



Bits 4. 5, 6, and 7 are not used. 

Status 15 Returns current modem line interrupt mask. 

Control 15 Sets modem line interrupt mask. Enables an interrupt to ON INTR when Bit 3 of 
Control Register 13 is set as follows: 



Bit 




1 
2 
3 

4 



Value 



1 
2 
4 



Modem Line to Cause Interrupt 



Data Mode (Data Set Ready) 

Receive Ready (Data Carrier Detect) 

Clear-to-send 

OCRl, Incoming Call (Ring Indicator) 

0CR2, Cable or adapter dependent 



16 
Reset Value = 

Note that bit functions are the same as for STATUS register 7. Functions shown are for 
male connector cable option for modem connections. 



Status 16 Returns current connection timeout limit. 
Control 16 Sets Attempted Connection timeout limit. 

Acceptable values: 1 thru 255 seconds. = 

Reset Value = 25 seconds 



timeout disabled. 



Status 17 Returns current No Activity timeout limit. 
Control 17 Sets No Activity timeout limit. 

Acceptable values: 1 thru 255 minutes. = timeout disabled. 

Reset Value = 10 minutes (disabled if Async, non-modem handshake). 

Status 18 Returns current Lost Carrier timeout limit. 
Control 18 Sets Lost Carrier timeout limit in units of 10 ms. 

Acceptable values: 1 thru 255. = timeout disabled. 

Reset Value = 40 (400 milliseconds) 



1 Transparent/Normal format identification control block occurs at ttiti BEGINNING of a given block of data in the receive queue. 
^ ETX and ETB Block Termination identification control blocks occur at the END of a given block of data in the receive queue. 
J This control block precedes each character containing a parity or framing error 
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Status 19 Returns current Transmit timeout limit. 

Control 19 Sets Transmit timeout limit (loss of cioclc or CTS not returned by modem wiien transmis- 
sion is attempted). 

Acceptable values: 1 thru 255.0 = timeout disabled. 
Reset Value = 10 seconds 

Status 20 Returns current transmission speed (baud rate). See table for values. 
Control 20i Sets transmission speed (baud rate) as follows: 



Register 




Register 




Value 


Baud Rate 


Value 


Baud Rate 





External Clock 


8 


600 


*1 


50 


9 


1200 


*2 


75 


10 


1800 


*3 


110 


11 


2400 


*4 


134.5 


12 


3600 


*5 


150 


13 


4800 


*6 


200 


14 


9600 


7 


300 


15 


19200 



* Async only. These values cannot be used with Data Link. These values set transmit speed 
ONLY for Async; transmit AND receive speed for Data Link. Default value is defined by the 
interface card configuration switches. 



Status 21 Protocol dependent. Returns receive speed (Async) or GID address (Data Link) as 

specified by Control Register 21. 
Control 21 Protocol dependent. Functions are as follows: 

Data Link: Sets Group IDentifier (GID) for terminal. Values thru 26 correspond to 
identifiers @, A, B,...Y, Z, respectively. Other values cause an error. Default 
value is 1 ("A"). 

Async: Sets datacomm receiver speed (baud rate). Values and defaults are the same 

as for Control Register 20. 

Status 22 Protocol dependent. Returns DID (Data Link) or protocol handshake type (Async) 

as specified by Control Register 22. 
Control 22 Protocol dependent. Functions are as follows: 

Data Link: Sets Device IDentifier (DID) for terminal. Values are the same as for Control 
Register 21. Default is determined by interface card configuration switches. 

Async: Defines protocol handshake type that is to be used. 



Value 




1 
2 
3 
4 
5 



Handshake type 



Protocol handshake disabled 

ENQ/ACK with desktop computer as the host 

ENQ/ACK, desktop computer as a terminal 

DC1/DC3, desktop computer as host 

DC1/DC3, desktop computer as a terminal 

DC1/DC3, desktop computer as both host and terminal 
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Status 23 Returns current hardware handshake type. 
Control 23 Sets hardware handshake type as follows: 

= Handshake OFF, non-modem connection. 

1 = FULL-DUPLEX modem connection. 

2 = HALF-DUPLEX modem connection. 

3 = Handshake ON, non-modem connection. 

Reset Value is determined by interface configuration switches. 

Status 24 Protocol dependent. Returns value set by preceding CONTROL statement to Con- 
trol Register 24. 

Control 24 Protocol dependent. Functions as follows: 

Data Link protocol: Set outbound block size limit. 



Value 



Status 25 




1 
2 
3 



Block size 



Value 



512 bytes 
2 bytes 
4 bytes 
6 bytes 



255 



Block size 



8 bytes 



510 bytes 



Reset outbound block size limit = 512 bytes 

Async Protocol: Set mask for control characters included in receive data message queue. 
Bit set: transfer character(s). 
Bit cleared: delete character(s). 

Character(s) passed to receive queue 

Handshake characters (ENQ, ACK, DCl, DCS) 
Inbound End-of-line character(s) 
Inbound Prompt character{s) 
NUL (CHR$(0)) 
DEL i:CHR$(127)) 
CHR$(255) 

Change parity/framing errors to underscores (_) if bit is set. 
Not used 
Reset value = 127 (bits thru 6 set) 

Returns number of received errors since power up or 
reset. 



Bit set 


Value 





1 


1 


2 


2 


4 


3 


8 


4 


16 


5 


32 


6 


64 


7 


128 



Note 
Control Registers 26 through 35, Status Registers 27 through 35, 
and Control and Status Registers 37 and 39 are used for ASYNC 
protocol ONLY. They are not available during Data Link operation. 



Status 26 Protocol dependent 

Data Link protocol: Returns number of transmit errors (NAKs received) since last interface 
reset. 

Async protocol: Returns first protocol handshake character (ACK or DCl). 
Control 26 Sets first protocol handshake character as follows: 
(Async only) 6 = ACK, 17 = DCl. Other values used for special applications only. Reset value = 17 

(DCl ). Use ACK when Control Register 22 is set to 1 or 2. Use DCl when Control Register 

22 is set to 3, 4, or 5. 
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Status 27 Returns second protocol handshake character. 

(Async only) 

Control 27 Sets second protocol handshake character as follows: 

(Async only) 5 = ENQ, 19 = DCS. Other values used for special applications only. Reset value = 19 

(DCS). Use ENQ when Control Register 22 is set to 1 or 2. Use DCS when Control Register 

22 is set to 3, 4, or 5. 

Status 28 Returns number of characters in inbound 

(Async only) End-of-line delimiter sequence. 

Control 28 Sets number of characters in End-of-line delimiter sequence 

(Async only) Acceptable values are (no EOL delimiter), 1, or 2. Reset Value = 2 

Status 29 Returns first End-of-line character. 

(Async only) 

Control 29 Sets first End-of-line character. Reset Value = 13 (carriage return) 

(Async only) 

Status 30 Returns second End-of-line character. 

(Async only) 

Control 30 Sets second End-of-line character. Reset Value = 10 (line feed) 

(Async only) 

Status 31 Returns number of characters in Prompt sequence. 
(Async only) 

Control 31 Sets number of characters in Prompt sequence. 
(Async only) Acceptable values are (Prompt disabled), 1 or 2. 
Reset Value = 1 

Status 32 Returns first character in Prompt sequence. 
(Async only) 

Control 32 Sets first character in Prompt sequence. 
(Async only) Reset Value = 17 (DCl) 

Status 33 Returns second character in Prompt sequence. 
(Async only) 

Control 33 Sets second character in Prompt sequence. 
(Async only) Reset Value = (null) 

Status 34 Returns the number of bits per character. 
(Async only) 

Control 34 Sets the number of bits per character as follows: 
(Async only) = 5 bits/character 2 = 7 bits/character 

1=6 bits/character 3 = 8 bits/character) 

When 8 bits/char, parity must be NONE, ODD, or EVEN. 

Reset Value is determined by interface card default switches. 



328 The Datacomm Interface 



Status 35 Returns the number of stop bits per character. 
(Async only) 

Control 35 Sets the number of stop bits per character as follows: 
(Async only) = 1 stop bit 1 = 1.5 stop bits 2 = 2 stop bits 

Reset Value: 2 stop bits if 150 baud or less, otherwise 1 stop bit. 

Reset Value is determined by interface configuration switch settings. 

Status 36 Returns current Parity setting. 

Control 36 Sets Parity for transmitting and receiving as follows: 

Data Link Protocol: = NO Parity; Network host is HP 1000 Computer. 

1 = ODD Parity; Network host is HP 3000 Computer. 

Reset Value = 
Async Protocol : = NONE; no parity bit is included with any characters. 

1 = ODD; Parity bit SET if there is an EVEN number of 

"r"s in the character body. 

2 = EVEN; Parity bit OFF if there is an ODD number of 

"T's in the character body. 

3 = "0"; Parity bit is always ZERO, but parity is not checked. 

4 = "1"; Parity bit is always SET, but parity is not checked. 

Default is determined by interface configuration switches. If 8 bits per character, parity 
must be NONE, ODD, or EVEN. 

Status 37 Returns inter-character time gap in character times. 
(Async only) 

Control 37 Sets inter-character time gap in character times. 
(Async only) Acceptable values: 1 thru 255 character times. 

= No gap between characters. Reset Value = 

Status 38 Returns Transmit queue status. 

If returned value = 1, queue is empty, and there are no pending transmissions. 

Status 39 Returns current Break time (in character times). 

(Async only) 

Control 39 Sets Break time in character times. 

(Async only) Acceptable values are: 2 thru 255. Reset Value = 4. 
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The RS-232 Serial Interface 



Chapter 



14 



Introduction 

The HP 98626 Serial Interface is an RS-232C compatible interface used for simple asynchro- 
nous I/O applications such as driving line printers, terminals, or other peripherals where the 
more sophisticated capabilities of the HP 98628 Data Communications Interface (see Chapter 
12) are not justified. It uses a UART (Universal Asynchronous Receiver and Transmitter) 
integrated circuit to generate the required async signals. The computer must provide most 
control functions because the card does not have its own processor capability. Consequently, 
there is more interaction between the card and computer than when you use a more intelligent 
interface except for relatively simple applications. An HP 98644 Serial Interface is also avail- 
able. Differences are described where necessary in the text, and are also summarized at the end 
of this chapter. 

The RS-232C interface standard' establishes electrical and mechanical interface requirements, 
but does not define the exact function of all the signals that are used by various manufacturers 
of data communications equipment and serial I/O devices. Consequently, when you plug your 
serial interface into an RS-232 connector, there is no guarantee the devices can communicate 
unless you have configured optional parameters to match the requirements of the device you 
are connecting to. 

Asychronous Data Communication 

The terms Asynchronous (Async for short) data communication and Serial I/O refer to a 
technique of transferring information between two communicating devices by means of bit- 
serial data transmission. This means that data is sent, one bit at a time, and that characters are 
not synchronized with preceding or subsequent data characters; that is, each character is sent as 
a complete entity without relationship to other events, before or after. Characters may be sent 
in close succession, or they may be sent sporadically as data becomes available. Start and stop 
bits are used to identify the beginning and end of each character, with the character data placed 
between them. 

Character Format 

Each character frame consists of the following elements: 

• Start Bit: The start bit signals the receiver that a new character is being sent. Since the 
receiver knows how many bits per second are being transmitted (specified by the baud 
rate), it can determine the expected arrival time for all subsequent bits in that character 
frame. All other bits in a given frame are synchronized to the start bit. 



1 RS-232C is a data communication standard established and published by the Electronic Industries Association (EIA) Copies of the standard 
are available from the association at 2001 Eye Street N. W., Washington D. C. 20006. Its equivalent for European applications is CCITT 
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• 5-8 Character Data Bits: The next bits are the binary code of the character being 
transmitted, consisting of 5, 6, 7, or 8 bits; depending on the application. The parity bit is 
not included in the character data bits. 

• Parity Bit: The parity bit is optional, included only when parity is enabled. 

• Stop Bit(s): One or more stop bits identify the end of each character. The serial interface 
has no provision for inserting time gaps between characters. 

Here is a simple diagram showing the structure of an asynchronous character and its rela- 
tionship to other characters in the data stream: 



Preceding 
Character 



Line in 
Idle State 
(Mark) 



+ 



Start 
Bit 







Parity 
Bit 



Stop 
Bit 



- Single Character Frame ■ 



hh- 



Beginning of 
Character 



End of 
Character 



Start Bit 
for Next 
Character 



Parity 

The parity bit is used to detect errors as incoming characters are received. If the parity bit does 
not match the expected sense, the character is assumed to be incorrectly received. The action 
taken when an error is detected depends upon how the interface and the desktop computer 
program are configured. 

Parity sense is determined by system requirements. The parity bit may be included or omitted 
from each character by enabling or disabling the parity function. If the parity bit is enabled, four 
options are available. Parity is checked by the receiver for all parity options including ONE and 
ZERO. (The HP 98046 and HP 98628 Datacomm Interfaces do not check parity when parity is 
set to ONE or ZERO.) 

Parity options include: 

• NONE Parity function is DISABLED, and the parity bit is omitted from each character frame. 

• ODD Parity bit is SET if there is an EVEN' number of ones in the data character. The 

receiver performs parity checks on incoming characters. 

• EVEN Parity bit is SET if there is an ODD' number of ones in the data character. The receiver 

performs parity checks on incoming characters. 

• ONE Parity bit is set for all characters. Parity is checked by the receiver on all incoming 

characters. 

• ZERO Parity bit is cleared, but present for all characters. Parity is checked by the receiver on 

all characters. 



1 Parity sense is determined by counting the number of ones in the character INCLUDING the parity bit. Consequently, the parity sense is 
reversed from the number of ones in a character without the parity bit. 
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Error Detection 

Two types of incoming data errors can be detected by serial receivers: 

• Parity errors are signalled when the parity bit does not match the number of ones, includ- 
ing the parity bit, even or odd as defined by interface configuration. When parity is 
disabled, no parity check is made. 

• Framing errors are signaled when start and stop bits are not properly received during the 
expected time frame. They can be caused by a missing start bit, noise errors near the end 
of the character, or by improperly specified character length at the transmitter or receiver. 

Two additional error types are detected by the receiver section of the serial interface: 

• Overrun errors result when the desktop computer does not consume characters as fast as 
they arrive. The card provides only one character of buffer space, so the current character 
must be consumed by an ENTER before the next character arrives. Otherwise, the charac- 
ter is lost when the next character replaces it, and an error is sent to BASIC. 

• Received BREAKs are detected as a special type of framing error. They generate the same 
type of BASIC error as framing errors. 

Data Transfers Between Computer and Peripheral 

Four statements are used to transfer information between your desktop computer and the 
interface card: 

• The CONTROL statement is used to control interface operation and defines such para- 
meters as baud rate, character format, or parity. 

• The OUTPUT statement sends data to the interface which, in turn, sends the information 
to the peripheral device. 

• The ENTER statement inputs data from the interface card after the interface has received it 
from the peripheral device. 

• The STATUS statement is used to monitor the interface and obtain information about 
interface operation such as buffer status, detected errors, and interrupt enable status. 

Since the interface has no on-board processor, ENTER and OUTPUT statements cause the 
computer to wait until the ENTER or OUTPUT operation is complete before continuing to the 
next line. For OUTPUT statements, this means that the computer waits until the last bit of the 
last character has been sent over the serial line before continuing with the next program 
statement. 
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Overview of Serial Interface Programming 

Serial interface programming techniques are similar to most general I/O applications. The 
interface card is initialized by use of CONTROL statements; STATUS statements evaluate its 
readiness for use. Data is transferred between the desktop computer and a peripheral device by 
OUTPUT and ENTER statements. In most cases, default configuration switches on the interface 
card can be used to eliminate or significantly reduce the need for using CONTROL statements 
to initialize the card. 

Due to the asynchronous nature of serial I/O operations, special care must be exercised to 
ensure that data is not lost by sending to another device before the device is ready to receive. 
Modem line handshaking can be used to help solve this problem. These and other topics are 
discussed in greater detail elsewhere in this chapter. 



Initializing the Interconnection 

Determining Operating Parameters 

Before you can successfully transfer information to a device, you must match the operating 
characteristics of the interface to the corresponding characteristics of the peripheral device. This 
includes matching signal lines and their functions as well as matching the character format for 
both devices. 

Hardware Parameters 

To determine hardware operating parameters, you need to know the answer for each of the 
following questions about the peripheral device: 

• Which of the following signal and control lines are actively used during communication 
with the peripheral? 

_ Data Set Ready (DSR) _ Data Carrier Detect (DCD or CD) 

_ Clear to Send (CTS ) — Ring Indicator ( RI) 

• What baud rate (line speed) is expected by the peripheral? 

Character Format Parameters 

To define the character format, you must know the requirements of the peripheral device for 
the following parameters: 

• Character Length: How many data bits are used for each character, excluding start, stop, 
and parity bits? 

• Parity Enable: Is parity enabled (included) or disabled (absent) for each character? 

• Parity Sense: Is the parity bit, if enabled, ODD, EVEN, always ONE, or always ZERO? 

• Stop Bits: How many stop bits are included with each character: 1, 1.5, or 2? 
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Using Interface Defaults to Simplify Programming 

The serial interface includes three default configuration switch clusters in addition to the select 
code and Interrupt level switches. Their functions are described in the following paragraphs. 

Modem Line Disconnect Switches 

The Modern Line Disconnect switches are used to connect or disconnect the following modem 
lines from the interface cable: 



• Data Set Ready (DSR) 

• Data Carrier Detect (DCD or CD) 

• Clear to Send (CTS) 

• Ring Indicator (RI) 

When a given switch is in the CONNECT position, the corresponding modem line is connected 
from the peripheral device to the interface circuitry. When it is in the disconnected position, the 
modem line is disconnected, and the inteirface receiver input for that line is held HIGH (true). 
Any modem lines that are not actively used while communicating with the peripheral should be 
disconnected to minimize errors due to electrical noise in the cable. Modem line disconnect 
switch settings cannot be altered under program control. To reconfigure the switches, the 
interface must be removed from the computer, and the settings changed by hand. 

Note 

The built-in 98626 serial interface in Series 200 Models 216 and 217 
and 98644 interface in Series 300 computers have no "modem-line 
disconnect" switches. Because switch settings can vary, cable con- 
nections between the computer and an external device can require 
some cross-wiring. Use of a breakout box can be helpful. 

Baud Rate Select Switches' 

The rate at which data bits are transferred between the interface and the peripheral is called the 
baud rate. The interface card must be set to transmit and receive at the same rate as the 
peripheral, or data cannot be successfully transferred. To preset the baud rate, the Baud Rate 
Select switches can be set to any one of the following values: 





Switch Settings 




Switch Settings 


Baud Rate 


3 2 10 


Baud Rate 


3 2 10 


50 





1200 


10 


75 


1 


1800 


10 1 


110 


10 


2400 


10 10 


134.5 


11 


3600 


10 11 


150 


10 


4800 


110 


200 


10 1 


7200 


110 1 


300 


Olio 


9600 


1110 


600 


111 


19200 


1111 



1 These switches are not implemented on the 98644 interface. See the description of register 13, which allows you to set a "SCRATCH A 
default" value for the baud rate. 
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Line Control Switches' 

The Line Control switches are used to preset character format and parity options. Functions are 
as follows: 



1 


-*arity Sense 




'arity Enable 




Stop Bits 


Character Length 


(Switches 5&4) 


(Switch 3) 


(Switch 2) 


(Switches l&O) 


00 


ODD parity 





Disabled 


' 


1 stop bit 


00 


5 bits/char 


01 


EVEN parity 


1 


Enabled 


1 


1.5 stop bits 


01 


6 bits/char 


10 


Always ONE 








if 5 bits/char 


10 


7 bits/char 


11 


Always ZERO 








or 2 stop bits 
if 6, 7, or 8 

bits/char 


11 


8 bits/char 



Bits 6 and 7 are reserved for future use. 

Using Program Control to Override Defaults 

You can override some of the interface default configuration options by use of CONTROL 
statements. This not only enables you to guarantee certain parameters, but also provides a 
means for changing selected parameters in the course of a running program. Control Register 
tables are listed at the end of this chapter as well as in the BASIC Language Reference. Refer to 
them as needed during the discussion which follows. 

Interface Reset 

Whenever an interface is connected to a modem that may still be connected to a telecom- 
munications link from a previous session, it is good programming practice to reset the interface 
to force the modem to disconnect, unless the status of the link and remote connection are 
known. When the interface is connected to a line printer or similar peripheral, resetting the 
interface is usually unnecessary unless an error condition requires it. 

When the interface is reset by use of a CONTROL statement to Control Register with a 
non-zero value, the interface is restored to its power-up condition, except that the current 
character format is not altered, whether or not it is the same as the current default switch 
configuration. If you are not sure of the present settings, or if your application requires changing 
the configuration during program operation, you can use CONTROL statements to configure 
the interface. An example of where this may be necessary is when several peripherals share a 
single interface through a manually operated RS-232 switch such as those used to connect 
multiple terminals to a single computer port, or a single terminal to multiple computers. 

Selecting the Baud Rate 

In order to successfully transfer information between the interface card and a peripheral, the 
interface and peripheral must be set to the same baud rate. A CONTROL statement to register 3 
(or 13 with 98644 interfaces) can be used to set the interface baud rate to any one of the 
following values: 



50 


150 


1200 


4800 


75 


200 


1800 


7200 


110 


300 


2400 


9600 


134.5 (or 134) 


600 


3600 


19 200 



1 Thest? switches arc not implemented on thf 98644 interface. See the description of register 14, which allows uou to set a "SCRATCH A 
default" value for character format. 
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For example, to select a baud rate of 3600, the following program statement is used: 

1190 CONTROL Sc ,3;3B00 

Use of values other than those shown may result in incorrect operation. 

To verify the current baud rate setting, use a STATUS statement addressed to register 3. All 
rates are in baud (bits/second). 

Setting Character Format and Parity 

Control Register 4' overrides the Line Control switches that control parity and character format. 
To determine the value sent to the register, add the appropriate values selected from the 
following table: 





Parity Sense 




*arity Enable 




Stop Bits 


Character Length 



16 
32 
48 


ODD Parity 
EVEN Parity 
Always ONE 
Always ZERO 



8 


Disabled 
Enabled 



4 


1 stop bit 
1.5 stop bits 
if 5 bits/char 
or 2 stop bits 
if 6, 7, or 8 
bits/char 



1 
2 
3 


5 bits/char 

6 bits/char 

7 bits/char 

8 bits/char 



For example, to configure a character format of 8 bits per character, two stop bits, and EVEN 
parity, use the following CONTROL statement: 



1200 CONTROL Sc »a i 3+a+8+ IB 



or 



1200 CONTROL Be .4 531 

To configure a 5-bit character length with 1 stop bit and no parity bit, use the following: 

1200 CONTROL Sc t4i0 



1 With 98644 interfaces, there are no Line Control switches. You can simulate their effect by writing to CONTROL register 14. Note that 
individual bits of this register are the same as for register 4. 
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Data Transfers 

The serial interface card is designed for relatively simple serial I/O operations. It is not intended 
for sophisticated applications that use ON INTR statements extensively to service the interface. 
If your situation requires full interrupt capability such as in terminal emulator applications, use 
the HP 98628 Datacomm Interface instead. Limited ON INTR capabilities are provided by the 
serial interface for error trapping and other simple tasks. 

Program Flow 

When the interface is properly configured, either by use of default switches or CONTROL 
statements, you are ready to begin data transfers. OUTPUT statements are used to send 
information to the peripheral; ENTER statements to input information from the external device. 
Any valid OUTPUT or ENTER statement and variable(s) list may be used, but you must be sure 
that the data format is compatible with the peripheral device. For example, non-ASCII data sent 
to an ASCII line printer results in unpredictably behavior. 

Various other I/O statements can be used in addition to OUTPUT and ENTER, depending on 
the situation. For example, the LIST statement can be used to list programs to an RS-232 line 
printer PROVIDED the interface is properly configured before the operation begins. 

Data Output 

To send data to a peripheral, use OUTPUT, OUTPUT USING, or any other similar or equiva- 
lent construct. Suppression of end-of-line delimiters and other formatting capabilities are iden- 
tical to normal operation in general I/O applications. The OUTPUT statement hangs the com- 
puter until the last bit of the last character in the statement variable list is transmitted by the 
interface. When the output operation is complete, the computer then continues to the next line 
in the program. 

Data Entry 

To input data from a peripheral, use ENTER, ENTER USING, or an equivalent statement. 
Inclusion or elimination of end-of-line delimiters and other information is determined by the 
formatting specified in the ENTER statement. The ENTER statement hangs the computer until 
the input variables list is satisfied. To minimize the risk of waiting for another variable that isn't 
coming, you may prefer to specify only one variable for each ENTER statement, and analyze 
the result before starting the next input operation. 

Be sure that the peripheral is not transmitting data to the interface while no ENTER is in 
progress. Otherwise, data may be lost because the card provides buffering for only one charac- 
ter. Also, interrupts from other I/O devices, or operator inputs to the computer keyboard can 
cause delays in computer service to the interface that result in buffer overrun at higher baud 
rates. 

Modem Line Handshaking 

Modem line handshaking, when used, is performed automatically by the computer as part of 
the OUTPUT or ENTER operation. If the modem line states have not been latched in a fixed 
state by Control Register 5, the following sequence of events is executed automatically during 
each OUTPUT or ENTER operation: 
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For OUTPUT operation, 

1. Set Data Terminal Ready and Request-to-Send modem lines to active state. 

2. Check Data Set Ready and Clear-to-Send modem lines to be sure they are active. 

3. Send information to the interface and thence to the peripheral. 

4. After data transfer is complete, clear Data Terminal Ready and Request-to-Send signals. 

For ENTER operation, 

1. Set Data Terminal Ready line to active state. Leave Request-to-Send inactive. 

2. Check Data Set Ready and Data Carrier Detect modem lines to be sure they are active. 

3. Input information from the interface as it is received from the peripheral. 

4. After the input operation is complete, clear the Data Terminal Ready signal. 

After a given OUTPUT or ENTER operation is completed, the program continues execution on 
the next line. 

Control Register 5 can be used to force selected modem control lines to their active state(s). 
The Data Rate Select and Secondary Request-to-Send lines are set or cleared by bits 3 and 2 
respectively. Request-to-send and Data Terminal Ready are held in their active states when bits 
1 and are true, respectively. If bits 1 and/or are false, the corresponding modem line is 
toggled during OUTPUT or ENTER as explained previously. 

Incoming Data Error Detection and Handling 

The serial interface card can generate several errors that are caused when certain conditions are 
encountered while receiving data from the peripheral device. The UART detects a given error 
condition and sets the corresponding bit in Status Register 10. The card then generates a 
pending error to BASIC. Errors can be generated by any of the following conditions: 

• Parity error. The parity bit on an incoming character does not match the parity expected 
by the receiver. This condition is most commonly caused by line noise. When this error 
occurs, bit 2 of Status Register 10 is set. 

• Framing error. Start and stop bit(s) do not match the timing expectations of the receiver. 
This can occur when line noise causes the receiver to miss the start bit or obscures the stop 
bits. When this error is detected, bit 3 of Status Register 10 is set. 

• Overrun error. Incoming data buffer overrun caused a loss of one or more data characters. 
This is usually caused when data is received by the interface, but no ENTER statement has 
been activated to input the information. Bit 1 of Status Register 10 is set when this error 
occurs. 

• Break received. A BREAK was sent to the interface by the peripheral device. The desktop 
computer program must be able to properly interpret the meaning of a break and take 
appropriate action. When this condition occurs, bit 4 of Status Register 10 is set. Since a 
BREAK is detected as a special type of framing error, the framing error indicator, bit 3, is 
also set. 
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All UART status errors are generated by INCOMING data, never by outbound data. When a 
UART error occurs, the corresponding bit of Status Register 10 is set, and a pending error 
(ERROR 167: Interface status error) is sent to BASIC. BASIC processes the error according to 
the following rules: 

• If an ENTER is in progress, the error is handled immediately as part of the ENTER process. 
An active ON ERROR causes the error trap to be executed. If no ON ERROR is active, the 
error is fatal and causes the program to terminate. 

• If an OUTPUT is in progress, or if there is no current activity between the computer and 
interface, the error is flagged, but nothing is done by BASIC until an ENTER statement is 
encountered. When the computer begins execution of the ENTER statement, if an ON 
ERROR is active, the error trap is executed. If there is no active ON ERROR for that select 
code, the fatal ERROR 167 causes the BASIC program to terminate. 

• If a STATUS statement is executed to Status Register 10 before an ElNTER statement is 
encountered for that select code, the pending BASIC error is cleared, and the program 
continues as if no error had been generated. Whenever a STATUS statement is executed 
to Status Register 10, bits 1 through 4 of the register are cleared and the data is destroyed. 
If you need to perform multiple operations (such as IF BIT tests) on the register contents, 
be sure to store the information in a variable before you use it. 

Trapping Serial Interface Errors 

Pending BASIC errors can be trapped by using an ON ERROR statement in conjunction with an 
error trapping service routine to evaluate the error condition. Here is an example technique: 



i20<: 
12 u: 

laoo 

i53(: 

1535 

isac 

155C 
15BC 
157(: 
15B<: 
1590 

165C 

1700 

1750 

IBOC 



Sc = 9 

ON ERROR GOTO Error 

ENTER Be ;A$ 



! Set serial interface select id ode. 
! Set LIP error trap routine. 

! Input line of data from interface. 



Error: ! Error trap routine: 

IF ERRN01B7 THEN Other_error 
STATUS Sc tlO ;L)art_e r ro r ! Get UART error information. 



IF BIT ( Ua rt_e r ro r t 1 ) THEN Ouerrun 

IF BIT (Uart_error »2) THEN Parity 

IF BIT (Uart_error ,a) THEN Break 

IF BIT {Uart_error .3) THEN Framing 
Other: 

M e r r u n : ! m e r r u n error routine: 

Parity: ! Parity error routine: 

F r a m i n 3 : ! Framing error routine: 



y e r r u n error. 
Parity error. 
BREAK received. 
F r a (ii i n 3 error. 
Other error type 



B r e a K : 



5REAK receiued routine: 



1850 Other_error: ! Not error 1B7. Process accord in 31' 
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This example is not intended to show a specific application, but only to illustrate the technique 
for trapping interface errors. Only UART errors are shown in this example, but the technique is 
valid for other errors related to a given interface. 

Note that in this example, the UART error information is checked for a BREAK before looking 
at the framing error bit. When a break is received, both the BREAK and framing error bits are 
set. Consequently, if the error check sequence were reversed, it would be necessary to check 
for a BREAK whenever a framing error is processed. Reversing the order eliminates an extra 
step by making it unnecessary to check for framing errors when a BREAK occurs. That is 
because whenever the BREAK is processed, the framing error is also cleared, making it un- 
necessary to perform any operations related to framing errors that are handled by the BREAK 
routine. 

Special Applications 

This section provides advanced programming information for applications requiring special 
techniques. 

Sending BREAK Messages 

A BREAK is a special character transmission that usually indicates a change in operating 
conditions. Interpretation of break messages varies with the application. To send a break 
message, send a non-zero value to Control Register 1 as follows (sc is the interface select code): 



1G40 CONTROL Sc >1 !! 



Serid a BREAK to peripheral. 



Using the Modem Control Register 

Control Register 5 controls various functions related to modem operation. Bits thru 3 control 
modem lines, and bit 4 enables a self-test loopback configuration. 

Modem Handshake Lines (RTS and DTR) 

As explained earlier in this chapter, Request-to-send and Data Terminal Ready lines are set or 
cleared at the beginning and end of each OUTPUT or ENTER operation. In some cases, it may 
be advantageous or necessary to maintain either or both in an active state. This is done by 
setting bit 1 or respectively in Control Register 5 as follows: 



1B50 CONTROL Sc »5;2 

IBGO CONTROL Sc .5 5 1 

1B70 CONTROL Sc .553 

1B80 CONTROL Sc t5;0 



Set RTS line only and hold active. 
Set DTR line only and hold aotiMe. 
Set both RTS and DTR lines actiue. 
Return to normal modem line handshaKe. 



When RTS and/or DTR are set by Control Register 5, they are NOT toggled during OUTPUT or 
ENTER operations, but remain constantly in an active state until the control register is cleared 
by a CON TROL statem en t or a n interface reset from Control Register or the computer 
keyboard ( ( SHIFT )fPAUSEl or ( Reset ) ). 
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Programming the DRS and SRTS Modem Lines 

Bits 3 and 2 of Control Register 5 control the present state of the Data Rate Select (DRS) and 
Secondary Request-to-send (SRTS) lines, respectively. When either bit is set, the correspond- 
ing modem line is activated. When the bit is cleared, so is the modem line. To set both lines, the 
following statement or its equivalent can be used: 

1B90 CONTROL Sc,5;B+4 ! Set DRS and SRTS lines. 

These lines are also cleared by a CONTROL statement to Control Register 5 with bits 2 and 3 
cleared, or by an interface reset. 

Configuring the Interface for Self-test Operations 

Self-test programs can be written for the serial interface. Prior to testing the interface, it must be 
properly configured. Using bit 4 of Control Register 5, you can rearrange the interconnections 
between input and output lines on the interface, enabling the interface to feed outbound data to 
the inbound circuitry. 

When LOOPBACK is enabled (bit 4 is set), the UART output is set to its MARK state and sent to 
the Transmitted Data (TxD) line. The output of the transmitter shift register is then connected to 
the input of the receiver shift register, causing outbound data to be looped back to the receiver. 
In addition, the following modem control lines are connected to the indicated modem status 
lines: 

Modem Control Line Modem Status Line 



DTR 


Data Terminal Ready 


GTS 


Clear-to-send 


RTS 


Request-to-send 


DSR 


Data Set Ready 


DCD 


Data Carrier Detect 


DRS 


Data Rate Select 


SRTS 


Secondary RTS 


RI 


Ring Indicator 



When loopback is active, receiver and transmitter interrupts are fully operational. Modem 
control interrupts are then generated by the modem control outputs instead of the modem 
status inputs. Refer to serial interface hardware documentation for information about card 
hardware operation. 

READIO and WRITEIO Register Operations 

For those cases where you need to write special interface driver routines, the interface card 
provides registers that can be accessed by use of READIO and WRITEIO statements. These 
capabilities are intended for use by experienced programmers who understand the inherent 
programming complexities that accompany this versatility. 

Some registers are read/write; that is, both READIO and WRITEIO operations can be per- 
formed on a given register. Writing places a new value in the register; a read operation returns 
the current value. All registers have 8 bits available, and accept values from through 255 
unless noted otherwise. When the value of a given bit is 1, the bit is set; otherwise, it is zero 
(cleared or inactive). 
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Note 

Some READIO and WRITEIO registers are similar in structure and 
function to Status and Control Registers. However, their interaction 
with the desktop computer operating system is considerably differ- 
ent. To prevent incorrect program operation, do NOT intermix the 
use of STATUS/CONTROL registers and READIO/WRITEIO regis- 
ters in a given program. 

Interface Registers 

READIO and WRITEIO registers 1, 3, 5, and 7 access interface registers. Their functions are as 
follows: 

Register 1: Interface Reset and ID 

READIO of Register 1 returns the interface ID value: 2 for the HP 98626 Serial Interface; 66 
for the HP 98644 interface. WRITEIO to Register 1 with any value, 1 through 255, resets the 
interface as when using a CONTROL statement to Control Register 0. 



Register 3: Interrupt Control 

Only the upper four bits of Register 3 are used. Bits 5 and 4 return the setting of the Interrupt 
Level switches on the interface'. Their values are as follows: 



00 Interrupt Level 3 

01 Interrupt Level 4 



10 Interrupt Level 5 

1 1 Interrupt Level 6 



Bit 6 is set when an interrupt request is originated by the UART. No machine interrupt can 
occur unless bit 7, Interrupt Enable is set by a WRITEIO statement. Only bit 7 can is affected by 
WRITEIO statements. During READIO, bit 7 returns the current enable value; bits 6 thru 4 
return interrupt request and level information. 

Register 5: Optional Circuit and Baud Rate Control 

WRITEIO to bits 7 and 6 control the state of optional circuit drivers 3 and 4, respectively. 
READIO returns current values of the respective drivers, plus the following: 

Bit 5 Optional Circuit Receiver 2 state. 

Bit 4 Optional Circuit Receiver 3 state. 

Bits 3-0 Current Baud Rate switch setting (not necessarily the current UART baud 
rate) as follows: 



Setting 


Baud Rate 


Setting 


Baud Rate 


0000 


50 


1000 


1200 


0001 


75 


1001 


1800 


0010 


110 


1010 


2400 


0011 


134.5 


1011 


3600 


0100 


150 


1100 


4800 


0101 


200 


1101 


7200 


Olio 


300 


1110 


9600 


0111 


600 


nil 


19 200 



1 With 98644 interface (which have no interrupt level switches), this register always indicates an interrupt level of 5. 
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Note that WRITEIO to this register can NOT be used to set the baud rate. Use Register 23, bit 7 
and Registers 17 and 19 instead. 

Register 7: Line Control Switch Monitor' 

READIO to this register enables you to input the present settings of the Line Control switches 
that preset default character format and parity. Bit functions are included in the table earlier in 
this chapter under Using Interface Defaults to simplify programming. Bits 7 thru correspond to 
switches 7 thru 0. respectively. WRITEIO operations to this register are meaningless. 

UART Registers 

Addresses 17 through 29 access UART registers. They are used to directly control certain UART 
functions. The function of Registers 17 and 19 are determined by the state of bit 7 of Register 
23. 

Register 17: Receive Buffer/Transmitter Holding Register 

When bit 7 of Register 23 is clear (0), this register accesses the single-character receiver buffer 
by use of READIO. A WRITEIO statement places a character in the transmitter holding register. 

The receiver and transmitter are doubly buffered. When the transmitter shift register becomes 
empty, a character is transferred from the holding register to the shift register. You can then 
place a new character in the holding register while the preceding character is being transmitted. 
Incoming characters are transferred to the receiver buffer when the receiver shift register 
becomes full. You can then input the character (READIO) while the next character is being 
constructed in the shift register. 

Registers 17 and 19: Baud Rate Divisor Latch 

When bit 7 of Register 23 is set (1), Registers 17 and 19 access the 16-bit divisor latch used by 
the UART to set the baud rate. Register 17 forms the lower byte; Register 19 the upper. The 
baud rate is determined by the following relationship: 

Baud Rate = 153 600/Baud Rate Divisor 

To access the Baud Rate Divisor latch, set bit 7 of Register 23. This disables access to the 
normal functions of Registers 17 and 19, but preserves access to the other registers. When the 
proper value has been placed in the latch, be sure to clear bit 7 of Register 23 to return to 
normal operation. 

Register 19: Interrupt Enable Register 

When bit 7 of Register 23 is clear (0), this register enables the UART to interrupt when specified 
conditions occur. Only bits thru 3 are used. WRITEIO establishes a new value for each bit; 
READIO returns the current register value. Interrupt enable conditions are as follows: 

Bit 3 Enable Modem Status Change Interrupts, when set, enables an interrupt whenever 
a modem status line changes state as indicated by Register 29, bits thru 3. 

1 Since the 98644 interface does not have these switches. READIO of this register will be meaningless. 
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Bit 2 Enable Receiver Line Status Interrupts, when set, enables interrupts by errors, or 

received BREAKs as indicated by Register 27, bits 1 thru 4. 
Bit 1 Enable Transmitter Holding Register Empty Interrupt, when set, allows interrupts 

when bit 5 of Register 27 is also set. 
Bit Enable Receiver Buffer Full Interrupts, when set, enables interrupts when bit of 

Register 27 is also set. 

Register 21: Interrupt Identification Register 

This register identifies the cause of the highest-priority, currently-pending interrupt. Only bits 2, 
1, and are used. Bit 0, if set, indicates no interrupt pending. Otherwise an interrupt is pending 
as defined by bits 2 and 1. Causes of pending interrupts in order of priority are as follows: 

Bits 2&1 Interrupt cause 

11 Receiver Line Status interrupt (highest priority) is caused when bit 2 of Register 19 is 

set and a framing, parity, or overrun error, or a BREAK is detected by the receiver 
(indicated by bits 1 thru 4 of Register 27). The interrupt is cleared by reading Register 
27. 

10 Receive Buffer Register Full interrupt is generated when bit of Register 19 is set and 

the Data Ready bit (bit 0) of Register 27 is active. To clear the interrupt, read the 
receiver buffer, or write a zero to bit of Register 27. 

01 Transmitter Holding Register Empty interrupt occurs when bit 1 of Register 19 is set 

and bit 5 of Register 27 is set. The interrupt is cleared by writing data into the 
transmitter holding register (Register 17 with bit 7 of Register 23 clear) with a 
WRITEIO statement, or by reading this register (Interrupt Identification). 

00 Modem Line Status Change interrupt occurs when bit 3 of Register 19 is set and a 

modem line change is indicated by one or more of bits thru 3 of Register 29. To 
clear the interrupt, read Register 29 which clears the status change bits. 

Register 23: Character Format Control Register' 

This register is functionally equivalent to Control and Status Register 4 except for bits 6 and 7. 
WRITEIO sets a new character format; READIO returns the current character format setting. 

Bit 7 Divisor Latch Access Bit, when set, enables you to access the divisor latches of the 
Baud Rate generator during read/write operations to registers 17 and 19. 

Bit 6 Set BREAK, when set, holds the serial line in a BREAK state (always zero), indepen- 
dent of other transmitter activity. This bit must be cleared to disable the break and 
resume normal activity. 
Bits 5,4 Parity Sense is determined by both bits 5 and 4. When bit 5 is set, parity is always 
ONE or ZERO. If bit 5 is not set, parity is ODD or EVEN as defined by bit 4. The 
combinations of bits 5 and 4 are as follows: 

00 ODD parity 10 Always ONE 

01 EVEN parity 11 Always ZERO 

Bit 3 Parity Enable, when set, sends a parity bit with each outbound character, and checks 
all incoming characters for parity errors. Parity is defined by bits 4 and 5. 

1 Since the 98644 interface does not have these switches, READIO of bits 5 through of this register will be meaningless. 
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Bit 2 Stop Bit(s) are defined by a combination of bit 2 and bits 1 & 



Bit 2 


Character Length 


Stop Bits 




1 
1 


5. 6, 7. or 8 
5 

6. 7, or 8 


1 

1.5 
2 



Bits l&O Character Length is defined as follows: 



Bits l&O 


Character Length 


00 


5 bits 


01 


6 bits 


10 


7 bits 


11 


8 bits 



Register 25: Modem Control Register 

This is a READ/WRITE register. READIO returns current control register value. WRITEIO sets a 
new value in the register. This register is equivalent to interface Control Register 5. 



Bit 4 



Bits 
Bit 2 

Bit: 



BitO 



Loopback, when set. enables a loopback feature for diagnostic testing. Serial line 
is set to MARK state, UART receiver is disconnected, and transmitter output shift 
register is connected to receiver input shift register. Modem line outputs and inputs 
are connected as follows: DTR to CTS, RTS to DSR, DRS to DCD, and SRTS to 
Rl. Interrupts are enabled, with interrupts caused by modem control outputs in- 
stead of inputs from modem. 

Data Rate Select controls the OCDl driver output. 1 = Active, 0=- Disabled. 
Secondary Request-to-Send controls the 0CD2 driver output. 1= Active, 
= Disabled. 

Request-to-Send controls the RTS modem control line state. When bit 1 = 1, RTS 
is always active. When bit 1 = 0, RTS is toggled by the OUTPUT statement as 
described earlier in this chapter. 

Data Terminal Ready holds the DTR modem control line active when the bit is 
set. If not set, DTR is controlled by the OUTPUT or ENTER statement as described 
earlier. 



Bits 7, 6, and 5 are not used. 
Register 27: Line Status Register 



Bit 7 
Bite 

Bits 



Bit 4 



Not used. 

Transmitter Shift Register Empty indicates no data present in transmitter shift 

register. 

Transmitter Holding Register Empty indicates no data present in transmitter 

holding register. The bit is cleared whenever a new character is placed in the 

register. 

Break Indicator indicates that the received data input remained in the spacing 

(line idle) state for longer than the transmission time of a full character frame. This 

bit is cleared when the line status register is read. 
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Bit 3 Framing Error indicates that a character was received with improper framing; that 

is, the start and stop bits did not conform with expected timing boundaries. 
Bit 2 Parity Error indicates that the received character did not have the expected parity 

sense. This bit is cleared when the register is read. 
Bit 1 Overrun Error indicates that a character was destroyed because it was not read 

from the receiver buffer before the next character arrived. This bit is cleared by 

reading the line status register. 
Bit Data Ready indicates that a character has been placed in the receiver buffer 

register. This bit is cleared by reading the receiver buffer register, or by writing a 

zero to this bit of the line status register. 

Register 29: Modem Status Register 

Bit 7 Data Carrier Detect, when set, indicates DCD modem line is active. 

Bit 6 Ring Indicator, if set, indicates that the RI modem line is active. 

Bit 5 Data Set Ready, if set, indicates that the DSR modem line is active. 

Bit 4 Clear-to-send, if set, indicates that CTS is active. 

Bit 3 Change in Carrier Detect, when set, indicates that the DCD modem line has 

changed state since the last time the modem status register was read. 
Bit 2 Trailing Edge of Ring Indicator is set when the RI modem line changes from 

active to inactive state. 
Bit 1 Delayed Data Set Ready is set when the DSR line has changed state since the last 

time the modem status register was read. 
Bit Change in Clear-to-send, if set, indicates that the CTS modem line has changed 

state since the last time the register was read. 



Cable Options and Signal Functions 

The HP 98626A Serial Interface is available with RS-232C DTE and DCE cable configurations. 
The DTE cable option consists of a male RS-232C connector and cable designed to function as 
Data Terminal Equipment (DTE) when used with the serial interface. This means that the cable 
and connector are wired so that signal paths are correctly routed when the cable is connected to 
a peripheral device wired as Data Communication Equipment (DCE), such as a modem. The 
cables are designed so that you can write programs that work for both DCE and DTE connec- 
tions without requiring modifications to accommodate equipment changes. 

The DCE cable option includes a female connector and cable wired so that the interface and 
cable behave like normal DCE. This means that signals are routed correctly when the female 
cable connector is connected to a male DTE connector. 

Line printers and other peripheral devices that use RS-232C interfacing are frequently wired as 
DTE with a female RS-232C chassis connector. This means that if you use a male (DTE) cable 
option to connect to the female DTE device connector, no communication can take place 
because the signal paths are incompatible. To eliminate the problem, use an adapter cable to 
convert the female RS-232C chassis connector to a cable connector that is compatible with the 
male or female interface cable connector. The HP 13242 adapter cable is available in various 
configurations to fit most common applications. Consult cable documentation to determine 
which adapter cable to use. 
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The DTE Cable 

The signals and functions supported by the DTE cable are shown in the signal identification 
table which follows. The table includes RS-232C signal identification codes, CCITT V.24 
equivalents, the pin number on the interface card rear panel connector, the RS-232C connec- 
tor pin number, the signal mnemonic used in this manual, whether the signal is an input or 
output signal, and its function. 



RS-232 DTE (male) Cable Signal Identification Tables 



Signal 


Interface 


RS-232C 








RS-232C 


V.24 


Pin# 


Pin# 


IVInemonic 


I/O 


Function 


AA 


101 


24 


1 


— 


- 


Safety Ground 


BA 


103 


12 


2 




Out 


Transmitted Data 


BB 


104 


42 


3 




In 


Received Data 


CA 


105 


13 


4 


RTS 


Out 


Request to Send 


CB 


108 


44 


5 


CTS 


In 


Clear to Send 


CC 


107 


45 


6 


DSR 


In 


Data Set Ready 


AB 


102 


48 


7 


- 


- 


Signal Ground 


CF 


109 


46 


8 


DCD 


In 


Data Carrier Detect 


SCF (0CR2) 


122 


47 


12 


SDCD 


In 


Secondary DCD 


SCA (0CD2) 


120 


15 


19 


SRTS 


Out 


Secondary RTS 


CD 


108.1 


14 


20 


DTR 


Out 


Data Terminal Ready 


CE(OCRl) 


125 


9 


22 


RI 


In 


Ring Indicator 


CH (OCDl) 


111 


40 


23 


DRS 


Out 


Data Rate Select 



Optional Circuit Driver/Receiver Functions 

Not all signals from the interface card are included in the cable wiring. RS-232C provides for 
four optional circuit drivers and two receivers. Only two drivers and two receivers are supported 
by the DCE and DTE cable options. They are as follows: 





Drivers 




Receivers 


Name 


Function 


Name 


Function 


OCDl 


Data Rate Select 


OCRl 


Ring Indicator 


0CD2 


Secondary Request-to-send 


0CR2 


Secondary Data Carrier Detect 


0CD3 


Not used 






OCD4 


Not used 







If your application requires use of 0CD3 or 0CD4, you must provide your own interface cable 
to fit the situation. 

The DCE Cable 

The DCE cable option is designed to adapt a DTE cable and serial or data communications 
interface to an identical interface on another desktop computer. It is also used with the serial 
interface to simulate DCE operation when driving a peripheral wired for DTE operation. The 
DCE cable is equipped with a female connector. Since most DTE peripherals are also equipped 
with female connectors (pin numbering is the same as the standard male DTE connector), an 
adapter (such as the HP 13242M) is used to connect the two female connectors as explained 
earlier. 



The RS-232 Serial Interface 347 



Note 
Not all RS-232C devices are wired the same. To ensure proper 
operation, you must know whether the peripheral device is wired as 
DTE or DCE. The interface cable option and associated adapter 
cable, if needed, must be configured to properly mate with the 
female DTE chassis connector. 

The following schematic diagram shows the input and output signals for the serial interface and 
how they are connected to a DCE peripheral. 
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This diagram shows an HP 13242M adapter cable connected to a DCE interface cable and a 
DTE peripheral. Note that RTS is connected to CTS in the DCE cable. If your peripheral uses 
RTS/CTS handshaking, a different adapter cable must be used with the appropriate DTE or 
DCE interface cable option. 
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RS-232C/CCITTV24^ 

The following table provides information about each data communications interface func- 
tion. The pin assignments are also shown. Not all of the functions provided by RS-232C are 
implemented. The functions denoted with an * arc implemented. 

RS-232C/CCITTV24' 



RS-232(: 



*Pinl 

*Pin2 

*Pin3 

*Pin4 

*Pin5 

*Pin6 

*Pin7 

*Pin8 

Pin 9 

Pin 10 

Pin 11 

*Pin 12 

Pin 13 



CCITT V24 



101 



103 



104 



105 



106 



107 



102 



109 



122 



121 



Signal Name 



PROTECTIVE GROUND. Electrical equipment frame and ac power 
ground. 

TRANSMITTED DATA. Data originated by the terminal to be 
transmitted via the sending modem. 

RECEIVED DATA. Data from the receiving modem in response to 
analog signals transmitted from the sending modem. 

REQUEST TO SEND. Indicates to the sending modem that the 
terminal is ready to transmit data. 

CLEAR TO SEND. Indicates to the terminal that its modem is ready 
to transmit data. 

DATA SET READY. Indicates to the terminal that its modem is not 
in a test mode and that modem power is ON. 

SIGNAL GROUND. Establishes common reference between the 
modem and the terminal. 

DATA CARRIER DETECT. Indicates to the terminal that its 
modem is receiving carrier signals from the sending modem. 

Reserved for test. 

Reserved for test. 

Unassigned. 

SECONDARY DATA CARRIER DETECT. Indicates to the terminal 
that its modem is receiving secondary carrier signals from the send- 
ing modem. 

SECONDARY CLEAR TO SEND. Indicates to the terminal that its 
modem is ready to transmit signals via the secondary channel. 



These signals are commonly used for 3 wire (no modem) links. 



1 [nternational Telephone and Telegraph Consultative Committee European standard. 
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RS-232C/CCITTV24 (Cont'd) 



RS-232C 



Pin 14 
*Pin 15 

Pin 16 

*Pin 17 

Pin 18 
*Pin 19 

*Pin 20 
Pin 21 
*Pin 22 
*Pin 23 
*Pin 24 
Pin 25 



CCITT V24 



118 



114 



119 



115 



120 



108.2 



110 



125 



111 



113 



Signal Name 



SECONDARY TRANSMITTED DATA. Data from the terminal to 
be transmitted by the sending modem's channel. 

TRANSMITTER SIGNAL ELEMENT TIMING. Signal from the 
modem to the transmitting terminal to provide signal element timing 
information. 

SECONDARY RECEIVED DATA. Data from the modem's secon- 
dary channel in response to analog signals transmitted from the 
sending modem. 

RECEIVER SIGNAL ELEMENT TIMING. Signal to the receiving 
terminal to provide signal element timing information. 

Unassigned. 

SECONDARY REQUEST TO SEND. Indicates to the modem that 
the sending terminal is ready to transmit data via the secondary 
channel. 

DATA TERMINAL READY. Indicates to the modem that the as- 
sociated terminal is ready to receive and transmit data. 

SIGNAL QUALITY DETECTOR. Signal from the modem telling 
whether a defined error rate in the received data has been exceeded. 

RING INDICATOR. Signal from the modem indicating that a ring- 
ing signal is being received over the line. 

DATA SIGNAL RATE SELECTOR. Selects one of two signaling 
rates in modems having two rates. 

TRANSMIT SIGNAL ELEMENT TIMING. Transmit clock provided 
by the terminal. 

Unassigned. 
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Summary QtRS-232 Serial 
Status and Control Registers 



General Notes: Most Control registers accept values in the range of zero through 255. Some 
registers accept only specified values as indicated, or higher values for baud 
rate settings. Values less than zero are not accepted. Higher-order bits not 
needed by the interface are discarded if the specified value exceeds the valid 
range. 

Reset value is the default value used by the interface after a reset or power-up 
until the value is overridden by a CONTROL statement. 

Status Card Identification 

Value returned: 2 indicates a 98626 (if 130 is returned, the Remote jumper wire has been 
removed from the Interface card); 66 indicates a 98644 (194 if the Remote jumper has 
been removed). 

Control Interface Reset 

Any value from 1 thru 255 resets the card. Execution is immediate; any data transfers in 
process are aborted and any buffered data is destroyed. A value of causes no action. 

Status 1 Interrupt Status 

Bit 7 set: Interface hardware interrupt to CPU enabled. 
Bit 6 set: Card is requesting interrupt service. 
Bits5&4: 00 Interrupt Level 3 ■ 
01 Interrupt Level 4 

10 Interrupt Level 5 

1 1 Interrupt Level 6 
Bits 3 thru not used. 

Control 1 Transmit BREAK 

Any non-zero value sends a 400 millisecond BREAK on the serial line. 

Status 2 Interface Activity Status 

Bit 7 thru 3 are not used. 

Bit 2 set: Handshake in progress. This occurs only during multi-line function calls. 
Bit 1 set: Firmware interrupts enabled (ENABLE INTR active for this select code). 
Bit 0: Reserved for future use. 



Status 3 Current Baud Rate 

Returns one of the values listed under Control Register 3. 

Control 3 Set New Baud Rate 

Use any one of the following values; 

50 150 1200 3600 

75 200 1800 4800 

110 300 2000 7200 

134.5 (or 134) 600 2400 9600 
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Status 4 Current Character Format 

See Control Register 4 for function of individual bits. 

Control 4 Set New Character Format 



Parity Sense' 


Parity Enable 


Stop Bits 


Character Length 


(Bits 5&4) 


(Bit 3) 


(Bit 2) 


(Bits l&O) 


00 ODD parity 


= Parity OFF 


= 1 stop bit 


00 5 bits 


01 EVEN parity 


1 = Parity ON 


1=2 stop bits' 


01 6 bits 


10 Always ONE 






10 7 bits 


11 Always ZERO 






11 8 bits 



Status 5 
Control 5 



Status 6 



Control 6 



Status 7 



Control 7 



Bits 7 and 6 are reserved for future use. 

Current Status of Modem Control Lines 

Returns CURRENT line state values. See Control Register 5 for function of each bit. 

Set Modem Control Line States 

Sets Modem Control lines or interface state as follows: 

Bit 4 set: Enables loopback mode for diagnostic tests. 

Bit 3 set: Set Secondary Request-to-Send modem line to active state. 

Bit 2 set: Set Data Rate Select modem line to active state. 

Bit 1 set: Force Request-to-Send modem line to fixed active state. 

Bit 1 clear: Toggle RTS line as in normal OUTPUT operations. 

Bit set: Force Data Terminal Ready modem line to fixed active state. 

Bit clear: Toggle DTR line as in normal OUTPUT and ENTER operations. 

Data In 

Reads character from input buffer. Buffer contents is not destroyed, but bit of Status 

Register 10 is cleared. 

Data Out 

Sends character to transmitter holding register. This register is sometimes used to transmit 
protocol control characters or other characters without using OUTPUT statements. Modem 
control lines are not affected. 

Optional Receiver/Driver Status 

Returns current value of optional circuit drivers or receivers as follows: 



Bits 
Bit 2 
Bitl 
BitO 



Optional Circuit Driver 3 (OCD3). 
Optional Circuit Driver 4 (0CD4). 
Optional Circuit Receiver 2 (0CR2). 
Optional Circuit Receiver 3 (0CR3). 



Other bits are not used (always 0). 

Set New Optional Driver States 

Sets (bit= 1) or clears (bit = 0) optional circuit drivers as follows: 

Bit 3: Optional Circuit Driver 3 (0CD3), 

Bit 2: Optional Circuit Driver 4 (0CD4). 

Other bits are not used. 



1 Parity sense valid only if parity is enabled (bit 3 = 1). If parity is disabled, parity sense is meaningless. 

2 If character lengtfi is 5 bits, bit 2 = 1 sends 15 stop bits with each character frame. 
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Status 8 Current Interrupt Enable Mask 

Returns value of interrupt mask associated with most recent ENABLE INTR statement. Bit 
functions are as follows: 

Bit 3: Enable interrupt on modem line change. Status Register 11 shows which mod- 
em line has changed. 
Bit 2: Enable interrupt on UART status error. This bit is used to trp ERROR 167 
caused by UART error conditions. Status Register 10, bits 4 thru 1 show cause 
of error. 
Bit 1: Enable interrupt when Transmitter Holding Register is empty. 
Bit 0: Enable interrupt when Receiver Buffer is full. 

Status 9: Cause of Current Interrupt 

Returns cause of interrupt as follows: 

Bits 2&1: Return cause of interrupt 

11 = UART error (BREAK, parity, framing, or overrun error). See Status Register 10. 

10 = Receiver Buffer full. Cleared by STATUS to Register 6. 

01 = Transmitter Holding Register empty. Cleared by CONTROL to Register 6 or 
STATUS to Register 9. 

00 = Interrupt caused by change in modem status line(s). See Status Register 11. 

Bit 0: Set when no active interrupt requests from UART are pending. Clear until all 
pending interrupts have been serviced. 



Status 10 UART Status 

Bit set indicates UART status or detected error as follows: 



Bit? 
Bit 6 
Bits 
Bit 4 
Bits 
Bit 2 
Bitl 
BitO 



Not used. 

Transmit Shift Register empty. 
Transmit Holding Register empty. 
Break received. 
Framing error detected. 
Parity error detected. 
Receive Buffer Overrun error. 
Receiver Buffer full. 



Status 11 Modem Status 

Bit set indicates that the specified modem line or condition is active. 



Bit 7 
Bit 6 
Bits 
Bit 4: 
Bit 3: 
Bit 2 
Bitl 
BitO 



Data Carrier Detect (DCD) modem line active. 
Ring Indicator (RI) modem line active. 
Data Set Ready (DSR) modem line active. 
Clear-to-Send (CTS) modem line active. 
Change in DCD line state detected. 
RI modem line changed from true to false. 
Change in DSR line state detected. 
Change in CTS line state detected. 
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Status Register 12 

Most Significant Bit 



Modem Handshake Control 

Least Significant Bit 



Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Carrier 

Detect 

Disable* 





Data Set 

Ready 

Disable** 


Clear to ' 

Send 
Disable*** 














Value = 128 


Value - 64 


Value = 32 


Value = 16 


Value = 8 


Value 4 


Value - 2 


Value = 1 



- Wait tor Carrier Detoct on Enter Ope'ations, 1 - Don't wait 

~ Wait tor Data Set Ready on Enter an<l Output Operations 1 Don t war 

" Wait tor Clear to Send on Output Operations, 1 = Dontwai! 



Control Register 12 

Most Significant Bit 



Modem Handshake Control 

Least Significant Bit 



Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Carrier 

Detect 

Disable* 


Not 
Used 


Data Set 

Ready 

Disable** 


Clear to 

Send 
Disable*** 


Not 
Used 


Not 

Used 


Not 
Used 


Not 
Used 


Value = 128 


Value 64 


Value = 32 


Value = 16 


Value - 8 


Value 4 


Value - 2 


Value = 1 



- Wait lor Carrier i)(!tecl on Enler Ope'ations. 1 - Don t wail 

- Wait for Data Set Ready on Enter an( I Output Operations 1 - Don t wa t 

- Wait for Clear to Send on Output Operations, 1 - Don't wait 



Interrupt Enable Register (ENABLE INTR) 

Most Significant Bit 



Least Significant Bit 



Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Not Used 


Modem 

Status 

Change 


Receiver 

Line 

Status 


Transmitter 

Holding 

Register 

Empty 


Receiver 

Buffer 

Full 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value == 2 


Value = 1 



Status 13 Read 98644 "SCRATCH A default" baud rate 

Returns the baud rate that will be restored whenever SCRATCH A is executed 
(same bit-definitions as STATUS register 3). 

Control 13 Set 98644 "SCRATCH A default" baud rate 

Sets both the "current" and the "default" baud rate that will be restored whenever 
SCF?ATCH A is executed (same bit-definitions as CONTROL register 3). Default 
value in this register is 9600 baud. 
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Status 14 Read 98644 "SCRATCH A default" character format 

Returns the character format parameters that will be restored whenever SCRATCH 
A is executed (same bit-definitions as STATUS register 4). 

Control 14 Set 98644 ' 'SCRATCH A default' ' character format 

Sets the character format parameters that will be restored whenever SCRATCH A is 
executed (same bit-definitions as CONTROL register 4). Default value in this register 
specifies a character format of 8 bits/character, 1 stop bit, and parity disabled. 



Model 216 gnd 217 
Built-in 98626 Interface Differences 

This section describes the differences between the HP 98626 Serial interface and the built-in Serial 
interface in the Model 216 (HP 9816) and 217 (HP 9817) Computers. 

The hardware differences between the built-in serial interfaces and the 98626 interface occur in the 
following areas: 

• There are no "Select Code" switches (the select code is hard-wired to 9). 

• There are no "Interrupt Level" switches (the interrupt level is hard -wired to 3). 

• There are no "Status Line Disconnect" switches (the modem status lines are always moni- 
tored; you cannot throw switches to make them "ALWAYS ON" like you can with with the 
98626 interface). 

There are no differences between programming these two interfaces with the BASIC system. 
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HP 98644 Interface Differences 

The HP 98644 RS-232 Serial Interface is nearly identical to the HP 98626 RS-232 Serial Interface. 
This section describes the few differences between them. 

Hardware Differences 

The differences in the hardware of the two cards occur in the following areas: 

• Card ID register contains 66 (rather than 2). 

• There are no optional driver and receiver lines. 

• There are fewer configuration switches (there are no Baud Rate or Line Control switches). 

• There is a 25-pin coverplate connector (instead of 50). 

• There are different cables available. 

Card ID Register 

The default card ID for the HP 98644 interface is 66. (The card ID of the 98626 is 2.) 



Note 

HP 98644 cards are logged as HP 98626 interfaces while booting 
machines with Boot ROM 3.0 (and earlier versions). This is not a prob- 
lem, because the BASIC recognizes the 98644 card properly. 

You can also change the card ID to 2 (to make It look like a 98626} by 
cutting a jumper on the card. See the 98644's installation manual for 
details. 

See the following "BASIC Differences" section for details of how to read this register with software. 

Optional Driver Receiver Circuits 

On the 98626 interface, there are two optional driver lines (0CD3 and 0CD4) and two optional 
receiver lines (0CR2 and 0CR3). These lines are not implemented on the 98644 interface. 

Configuration Switches 

The 98644 card does not implement the following configuration switches on the card: 

• Baud Rate 

• Line Control (character length, parity, etc.) 

These operating parameters are set to defaults that match the 98626 card by the BASIC system. 
See the subsequent "BASIC Differences" section for default values. 
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Coverplatt; Connector 

The connector on the 98644 interface's coverplate is set up for DTE (Data Terminal Equipment) 
applications; it has a 25-pin, female, D-series connector (the connector on the 98626 is a 50-pin 
connector). Here are the pin designators for the connector. 



Pin 


Signal Description 


1 


Safety Ground 


2 


Transmitted Data 


3 


Received Data 


4 


Request to Send 


5 


Clear to Send 


6 


Data Set Ready 


7 


Signal Ground 


8 


Carrier Detect 


9 


not used 


10 


not used 


11 


not used 


12 


not used 


13 


not used 


14 


not used 


15 


not used 


16 


not used 


17 


not used 


18 


not used 


19 


not used 


20 


Data Terminal Ready 


21 


not used 


22 


Ring Indicator 


23 


Data Rate Select 


24 


not used 


25 


not used 



Cables 

You can use standard RS-232C compatible cables, as long as the signal lines are connected 
properly. Here are cables available from HP Computer Supplies Operation. 



HP Produrt Number 



13242N 
13242G 
13242H 



Description 



Modem cable (male to male) 

DTE cable (male to male, with pins 2 and 3 reversed) 

DCE cable (male to female, with pins 2 and 3 reversed) 



BASIC Differences 

The only differences between programming these two interfaces with the BASIC system are in the 
register definitions given in this section. See the "Summary of RS-232 Serial Status and Control 
Registers" section for further details. 

Card ID Register 

The card ID register is Status register 0. It will contain a value of 66 if the interface is a 98644. (It will 
contain 2 if the card ID jumper has been cut.) If the REMOTE jumper has been removed, then the 
value returned will be 194 ( - 128 + 66) or 130 ( = 128 + 2). 

The card ID can also be determined by reading READIO register 1. 
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Optional Driver/Receiver Registers 

Since there are no optional driver or receiver lines on the 98644 interface, Status and Control 
register 7 are meaningless for this card. (Status register 7 always contains 0, and Control register 7 is 
a no-op. ) 

The hardware register bits that are not defined because of this difference are as follows: bits 7 and 6 
of WRITEIO register 5 (for writing 0CD3 and 0CD4, respectively); bits 7 and 6 of READIO register 
5 (for reading 0CD3 and 0CD4, respectively); bits 5 and 4 of READIO register 5 (for reading 
0CR2 and OCRS, respectively). 

Baud Rate and Line Control Registers 

Since there are no switches to set the default baud rate and line control parameters, the BASIC 
system sets them to its own default values, which are as follows: 



Parameter 


Default value 


Baud rate 


9600 baud 


Character length 


8 bits/character 


Stop bits 


1 stop bit 


Parity 


Parity disabled 


Parity type 


Odd parity 



Status registers 3 (baud rate) and 4 (line control) are still implemented for the 98644 interface and 
retain their original definitions. However, the hardware registers no longer contain any baud rate 
and line control information (since there are no switches to read). The hardware registers affected 
are READIO register 5 (bits 3 thru 0) and READIO register 7 (bits 7 thru 0), respectively. 

You can still program the baud rate and line control parameters by writing to Control register 3 
(baud rate) and Control register 4 (character format). These registers correspond to WRITEIO 
register 5 (bits 3 thru 0) and register 23 (bits 5 thru 0), respectively. 



Series 300 
Built-in 98644 Interface Differences 

The differences between the separate HP 98644 RS-232C serial interface and the built-in 98644- 
like interface of Series 300 computers are as follows: 

• There are no "Select Code'" switches (the select code is hard-wired to 9). 

• There are no "Interrupt Level" switches (the interrupt level is hard-wired to 5). 

There are no differences in programming these interfaces with the BASIC system. 
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With the HP 98270 Powerfail Protection option, Series 200 Model 226 and 236 computers have 
an optional capability of up to about one minute of powerfail protection. This chapter describes the 
capabilities provided by this optional internal interface, which has been permanently assigned to 
interface select code 5. 

This optional feature is discussed in this Interfacing Techniques manual because of the nature of 
its access from BASIC programs. If you need additional explanation regarding interface regis- 
ters or interface interrupt events, refer to Chapters 6 and 7 of this manual, respectively. 



Note 

The powerfail option is not available for all Series 200 computers. 
Also, not all Series 200 computers use the same monitors. The actual 
parameters you need may differ from those shown in some of the 
example programs. See the documentation for your hardware sys- 
tem for details. 
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Overview of Capabilities Provided 

The powerfail protection provided by the internal battery-backup circuitry is as follows. 

• A period of operation after powerfail may be specified. (See the hardware documentation 
for Option 050 for the Model 226 or 236 computers). 

• The interface may optionally interrupt the computer when a powerfail has occurred. A 
delay time before interrupt may also be programmed to allow the computer to ignore 
power "glitches". 

• The program can read both the powerfail interrupt cause and determine current powerfail 
status information, including ac power status, battery time remaining, and time elapsed 
since power was returned. 

• The real-time clock and 64 bytes of memory registers are maintained after power has been 
down for greater than one minute. 
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The Computer's Reaction to Powerfails 

There are two general categories of computer reactions to powerfail situations. The default 
response is to continue running as before the failure for up to one minute. The alternate 
response is to interrupt the current routine's execution to service the failure. In either case, the 
computer beeps and the following warning message is displayed on the CRT when the power- 
fail is detected. 

Power failed 

If power remains off for more than one minute, or if the computer turns itself off, only a real-time 
clock and 64 bytes of low-power memory registers are maintained. If power is restored, the 
computer powers on in its normal powerup sequence. 

Continuous-Memory Registers 

The sixty-four, single-byte registers on the interface are maintained after power has failed. The 
contents of these registers can be written with CONTROL statements and read with STATUS 
statements. The registers are numbered 8 through 71. 

Real-Time Clock 

The clock on the powerfail interface is read at powerup and is used to set the BASIC system 
clock. However, the system clock, not the powerfail clock, is read by the T I MED ATE function. 

Executing either SET TIME or SET TIMEDATE sets both clocks to the specified value. 
Thus, the two clocks may drift apart temporarily but may be synchronized by setting time with 
either of these statements. See Chapter 9 of BASIC Programming Techniques for further detail. 

Powerfail-Protection Timers 

Three additional timers are used by the interface to keep track of times between different 
powerfail events. These timers allow the program to keep track of Powerfail events so that the 
desired service response may be initiated. 

When a powerfail occurs, the Powerfail Timer is cleared and begins to count the seconds 
elapsed since the powerfail occurred. After waiting the Powerfail Delay Time, the interface 
may generate a Powerfail interrupt, if enabled to do so. If and when the Powerfail Timer timer 
reaches the value of the Protection Time, the computer automatically powers down. 

When power is returned, the Power Back Timer is cleared and begins counting seconds 
elapsed since the power back occurred. When this timer reaches the value of the Power Back 
Delay, the computer is no longer in the Powerfail State; a Power Back interrupt is generated, if 
enabled. 

When a powerfail occurs, the Overheat Protection Timer begins to increment, counting the 
seconds elapsed since the powerfail event occurred. When power is restored, this timer is 
decremented one second for every two seconds that power is back. If power remains on long 
enough, the timer decrements to 0. However, if the timer reaches 60 seconds, the computer 
automatically powers down. These actions ensure that the fan adequately cools the computer 
during continuous power fluctuations. 
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Further description of delay times, timer actions, and enabling interrupt events are described in 
the remainder of this chapter. 

Interrupt Events 

Interrupts can be generated by the powerfail-protection controller when three different events 
are sensed: when power fails, when power is returned, and when approximately one second of 
battery power remains. Enabling these events to initiate interrupts and typical responses to 
these events are explained in this and in the following section. 

Setting Up and Enabling Interrupts 

The desired interrupt condition(s) may be enabled by specifying the appropriate numeric mask 
value. The bits of the Interrupt Enable register enable the following interrupts. 



Most Significant Bit 








Powerfail Interrupt Enable Mask 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Not Used 


One 

Second 

Left 


Power 

Is 
Back 


Power 

Has 

Failed 


Valuer 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value - 1 



One Second Left — When this bit is set (1), an interrupt to the computer is generated when 
approximately one second of battery power remains. 

Power Is Back — When this bit is set (1), an interrupt to the computer is generated when 
power has been returned (after a previous powerfail). 

Power Has Failed — When this bit is set (1), an interrupt to the computer is generated when a 
powerfail has been detected. 

The branch to the powerfail service routine is set up and enabled in the same manner as are 
other interrupt service routines. A typical example is as follows. 

200 ON INTR 5 GOSUB PQwer_down 

210 Ma5K=l ! Enable Powerfail Interrupt. 

210 ENABLE INTR S^MasK 



Service Routines 

The service routine must determine which type of event initiated the interrupt branch. The bits 
of the Interrupt Cause register have the same definitions as those of the Interrupt Enable Mask 
register. 
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STATUS Register 1 

Most Significant Bit 








Powerfail Interrupt Cause 

Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


BitO 


Not Used 


One 

Second 

Left 


Power 

Is 
Back 


Power 

Has 

Failed 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



100 



STATUS 5*1 ; In te rrupt -cause 



If more than one interrupt cause has occurred, more than one bit will be set in this register. Also, 
the register's contents must be stored in a variable which is not used until all causes have been 
determineci, because reading this register clears its contents. 

Also keep in mind that when the "One Second Left" bit is a 1, the computer will power down 
regardless of whether on not power is back before the end of the one second. 

The action performed by the service routine is usually to store critical data. The internal disc 
drives remain fully operational for this purpose. External drives usually lose power when the 
computer loses its power; if so, they should not be used for this purpose. Other external devices 
may also be affected by the failure and therefore may not respond to the request to transfer the 
data. Therefore, all attempts to communicate with external devices should have ON TIMEOUT 
branches set up and enabled so that the program will not spend the entire minute waiting for 
the device to respond. 

Powerfail Status and Timers 

The Powerfail Status register and Timer registers provide useful information describing the state 
of computer power. The following example service routine reads these STATUS registers and 
displays the information on the CRT. 



1 
110 
120 
130 

lao 

150 
IGO 
170 
IBO 

leo 

2 
210 
220 



ON INTR 5 GDSUB 
ENABLE INTR 5 57 
! 

PlbacK_delav' = 300 
Protect iori = 2000 
Pf ai 1 -del ay = 100 



Pfail-seruice 
! Enable all three causes. 



I 



Delay 3 s before PbacK interrupt. 

20 s max. of Pfail protection. 

Delay 1 s before Pfail interrupt. 
CONTROL 5 j5 ;Pback_delay »Protection *Pf ail_delay 
! 

LOOP 

CONTROL i;i»l ! Upper-left corner. 

OUTPUT liNufiiber 

N u fii b e r = N u fii b e r + 1 
END LOOP 
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230 ! 

2<a0 Pf ai l_se ru ice : CONTROL i;i»3 ! BeSin on third line. 

250 OUTPUT 15" Powerfail Interface ReSiste 

rs" 

2B0 OUTPUT 15" 

IE 

27 ! 

280 REPEAT 

290 CONTROL 1;1j5 ! Be Sin printing on line 5. 

300 STATUS 5 t3;Pf_5tatus 

310 P f a i 1 = B I T ( P f _ s t a t Li s » ) 

320 A c _ d wn = B I T ( P f _ 5 t a t u s . 1 ) 

330 B a 1 1 _ n = B I T ( P f _ s t a t u s » 2 ) 

3^0 0ne_sec=BIT(Pf_status»3) 

350 S_test=BIT(Pf_status »7) 

3B0 OUTPUT 1 

370 OUTPUT i;"STATUS Register 3 - Powerfail Status:" 

380 OUTPUT li" Test Fail 1 Sec. Batt. On Ac 

Down In Pfail" 

380 OUTPUT 1 USING " « f 5X »D t5X " 5 S_t s t , On e_s e c tBa t t_on 

* A c _ d w n t P f a i 1 

-^00 OUTPUT 1 USING "/" 

mo ! 

420 STATUS 5,4;Duheat 

430 OUTPUT ir'STATUS Register 4 - Ouerheat Timer: 

5 

440 OUTPUT 1 USING " DD . D , / " ; Ou h e at / 1 00 

450 ! 

4G0 STATUS 5>5;PbacK 

470 OUTPUT 15"STATUS Register 5 - Power Back Timer:" 

5 

480 OUTPUT 1 USING " DD . D . / " 5 P b ac k / 1 00 

490 ! 

500 STATUS 5,G;Pf_timer 

510 OUTPUT i;"STATUS Register 6 - Powerfail Timer: " 

! 

520 OUTPUT 1 USING " DD . D » / " 5 Pf _t i me r/ 1 00 

530 ! 

540 STATUS 5f450u_heat 

550 UNTIL OM_heat=0 ! UNTIL Ouerheat timer eKPires. 

5B0 ! 

570 ENABLE INTR 5 ! Use same mask. 

580 RETURN 

590 ! 

BOO END 

Type in and run the program. Alternately remove and replace the power cord while watching 
the status values and timers change. You are highly encouraged to experiment with the para- 
meters until you are familiar with how the computer responds to power failures. The next 
section presents several simple examples of service routines. 



Use defaults of: 500 m s P b a c K Delay* 

GO 5 Protection Ti(iie» 
100 m s P f a i 1 D e 1 a v , 
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Typical Service Routines 

The Powerfail Protection option allows programming several types of service responses. A few 
typical examples are shown in this section. All STATUS and CONTROL registers are summa- 
rized at the end of the chapter. 

Using the Continuous-Memory Registers 

The most common function of service routines is to store any critical data and then turn the 
computer off to conserve battery power. The following simple example shows the use of the 
continuous-memory registers for storing a message. 

100 ON INTR 5 GOTO Pf a i 1 _s e r u e 

110 ENABLE INTR 55 1 ! Pfail interrupts only. 

120 

130 

140 

150 

ISO 

170 LOOP 

180 DISP Number 

190 Nuwbe r=Numbe r+1 

200 END LOOP 

210 ! 

220 E5T0P 

230 ! 

240 Pf ai l_se rue : ! Write message in Cont-Mem. Registers. 

250 ! 

2G0 MessaSe$="Adiost amiSos." 

270 Messa3e$ = Mes5aSe$&:CHR$( 10) ! Add LF. 

280 No_bytes=LEN(Me5sa^e$) 

290 ! 

300 FOR ReS=B TO 8+No_bytes-l 

310 CONTROL 5 »Re 3 JNUM ( Me ss a3e$ C Re S-7 5 1 ] ) 

320 NEXT Res 

330 ! 

340 CONTROL 5 51 ! Shut down when finished, 

350 ! 

380 END 

Type in the program and press ( RUN ) . The CRT shows a counter running continuously. 
Unplugging the power cord initiates the Powerfail interrupt after the default delay of 100 
milliseconds. Thus, if power had failed for a duration of less than 100 milliseconds, the interrupt 
would not have been generated. Similarly, the Power Back Delay determines how long the 
computer will delay after power has been restored before generating a Power Back interrupt, 
when enabled. 

The program did not allow the Powerfail Timer to reach the default Protection Time (60 
seconds). Instead, it powered itself down after storing a message in the registers in order to save 
battery power. If power is subsequently restored, the computer powers on in the normal 
powerup sequence. If an Autostart routine exists, it will be run automatically. 
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The following program shows a method for reading the message stored in the continuous- 
memory registers by the preceding program. The program makes use of the fact that the 
message was terminated by a line-feed character, CHR$(10). 
100 PRINTER IB 1 

110 ! 

120 ! Read message in C o n t i n u o u s - M e m o r y Registers. 
130 DIM ReSisters$CGa] »MessaSe$[B/4] 
140 ! 

150 FOR ReSister=8 TO 71 ! Read all G4 registers. 
180 STATUS 5 »Re^iste r ;By te 
170 Re3ister5$CRe3i5ter-73=CHR$(Byte) 
180 NEXT Register 
190 ! 

200 ENTER Re ^ i s t e rs$ 5 Me s s a ?e$ ! Enter and stop at LF. 
210 ! 

220 PRINT Message* 
230 ! 
240 END 

Storing Data on Disc 

Service routines can be programmed to take many other actions, such as to store data on an 

internal disc. The following program shows a technique for storing the ALPHA and GRAPHICS 

displays and the value of the clock at the time the powerfail occurred. This program requires 

GRAPH BIN file. 

100 INTEGER C r t_ ^ raph i c s (1 : 1 2480 ) ! (1:7500) for Model 228. 

110 DIM Crt_alpha$( 1 :57) ceo: ! [50] for Model 228. 

120 ! 

130 ON INTR 5 GOTO Pfail.serue 

140 ENABLE INTR 551 ! Pfail interrupts only. 

150 ! 

160 P b a c K _ d e 1 a y = 1 ! Delay 1 s before P b a c K interrupts 

* 

170 Protect ion=3000 ! 30 s max. of Protection Time, 

180 Pf ai l_delay=200 ! Delay 2 s before Pfail interrupts 

I 

190 CONTROL 5 >5 5 Pb ac K_d e 1 ay » P ro t e c t i on > Pf a i 1 _d e 1 ay 

2 ! 

210 FOR Crt_line=l TO 57 

220 OUTPUT ir'OutPut Area 1 in e " 5 C rt_l i n e 

230 NEXT Crt_Iine 

240 ! 

250 GCLEAR 

260 GRAPHICS ON 

270 FRAME 

280 MOOE 50 ,50 

290 LABEL "GRAPHICS DISPLAY" 

3 ! 
310 LOOP 

320 DIBP Number 
330 N u m b e r = N u m b e r + 1 
340 END LOOP 
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350 ! 

3B0 STOP 

370 ! 

380 Pf ai l_se rue : ! First* store GRAPHICS display. 

330 GSTORE C rt_ S raph i c s ( # ) 

400 ! 

aiO ! Then store ALPHA display. 

420 STATUS 1 »3 51 i n e s_ab ou e 

430 CONTROL 1 5 1 > -Lin e5_ab o u e+ 1 ! Moye print position 

440 ! to "top" of display . 

450 ENTER 1 USING " K " 5 C r t_a 1 ph a$ ( * ) ! Enter screen. 

4G0 ! 

470 ON ERROR GOTO Already 

480 CREATE BDAT " Pf a i l_d at a : INTERNAL »4 » 1 " » 1 1 B 

430 Already: OFF ERROR ! File already created. 

500 ASSIGN @File TO " Pf a i 1 _d at a : I NTERNAL *4 » 1 " 

510 OUTPUT @File ;Crt_3raphics (*) >Crt_alpha$(*) 

520 ! 

530 CONTROL 5;i ! Shut down when finished. 

540 END 

The INTEGER array used to store the graphics display was dimensioned for the Model 236's 
display (12 480 INTEGER elements). Other computers require different array sizes. See the 
GSTORE entry in the BASIC Language Reference for details. 

The size of the BDAT file was chosen for the "worst case" storage requirement. In order to 
calculate the maximum number of of disc sectors required to store both displays, you must 
determine three facts: the maximum number of data elements to be stored, the data type of 
each item, and the number of bytes required to store one element of each data type. 

The Model 236 display's Output-Area memory can hold up to 57 lines of 80 characters each 
(4 560 bytes). The graphics display requires 12 480 INTEGERS (24 960 bytes). A total of 
29 520 bytes of storage is required. Since BDAT files contain default records of 256 bytes each, 
the file "PfaiLdata" was dimensioned to 116 256-byte records. 

The following program gives a method of restoring the alpha and graphics displays and real- 
time clock. Actual programs would probably also restore other variables and resume program 
execution that was interrupted by the powerfail. This program requires GRAPH BIN file. 

100 ! This program for use on a Model 236! change 

110 ! array sizes and msus for use on a Model 22S. 

120 ! 

130 INTEGER G raph i cs (1 : 1 2480 ) ! (1:7500) for Model 22B. 

140 DIM Crt_alpha$( 1 :57) C80] ! C50] for Model 22B. 

150 ! 

ISO ASSIGN @File TO " Pf a i l_d at a : I NTERNAL »4 » 1 " 

170 ! ": INTERNAL »4 »0" for Model 22B. 

180 ENTER @File 5Graphics(#) 

180 ENTER eFile ;Crt_alpha$(*) 

200 ENTER (iFileJClock 

210 ! 
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23(: 

25( 

2G(: 

270 
28( 
29(: 
3 ( 
SIC 



GRAPHICS ON 

GLDAD Graphics(*) 
! 

OUTPUT 1 ;Crt_alpha$(#) 
! 

SET TIME ClocK 

D I S P "Powerfail occurred a t " 5 C 1 o c K 
! 

! 
END 



A very important consideration for the powerfail service routine is that it has enough battery 
time to store all the specified data. If there is insufficient battery time to allow storing all desired 
data, the service routine should be able to record exactly how far it got into the backup when 
battery power went down. The next example shows how to enable interrupts to signal that 
power is back or that only one second of battery power is left. 

Power-Is-Back and One-Second-Left Interrupts 

The powerfail-interface controller has the ability to sense when power is back and when 
approximately one second of battery power remains; it can optionally generate interrupts to the 
BASIC program when these events occur. The following example program shows how to 
enable and service these types of interrupts. 



1 
110 
120 
130 

lao 

150 
IBO 
170 



COM IfTiPortant_data$< 1 :8192) C2B] 

DIM Ran d 0(11$ C 28] 

! 

ON INTR 5»ia CALL P f a i 1 _ r e s pon s e 
ENABLE INTR 551 ! "Power Has Failed 



REPEAT 



i n t e r r u p t 5 , 



Main Program. 



370 UNTIL 

380 ! 

330 END 

a 00 ! 



Erro r< 1 . E-12 
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a 10 

azo 

430 
UUO 
450 
460 
470 
480 
490 
5 
510 
520 
530 
540 
550 
5G0 
570 
580 
590 
BOO 
BIO 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
860 



! ******** Powerfail Service Routine #*****## 

SUB Pf ai l-response 

COM IrTiPortarit_data$( 1 :8192) [28] 

DIH Messa3e$CG4] 



Set UP and enable s e r u i c e routine for 

"On e -Sec-Left " and "Power-BacK" interrupts! 

priority 15 allows data storage to be interrupted* 

ON INTR 5»15 GDSUB Stop.storinS 

ENABLE INTR 554+2 

I 

! Assume BOAT file (1024 records) exists. 

ASSIGN esterase TO "PFAIL_DATA" 

! Store elements individually to permit interrupts. 

FDR Element=l TO 8192 

OUTPUT eStoraSe > I mportant_data$( Element) 
NEXT Element 
I 



! Power Down 
CONTROL 551 

! 

! ********* 
Stop_storinS 



after all data stored. 



New service routine. ********* 
STATUS 5 »1 5 Int r-cause 
1 



IF BIT( Int r_cau5e t2) THEN ! One Second Left. 

! Define Message. 

MessaSe*="Only the first " &:OAL$ ( El emen t ) 

Messa^e$ = Me5sa3e$&:" elements have been stored." 

MessaSe$ = Mes5a3e$&:" Error="&:UAL$( Error) 

Messa3e$ = Messa9e*&:CHR$( 10) ! End with LF. 

! Write to Continuous-Memory Re^s. 

FOR Red=8 TO LEN ( Me s s a de$ ) +7 

CONTROL 5»Re3;NUM(Messa3e$CRe3-7;i]) 

NEXT Res 

! Power Dow n . 

CONTROL 551 
END IF 
! 

IF BIT( Int r_cause *1 ) THEN ! Power Is BacK. 

! R e - e n a b 1 e "Power Has Failed" interrupts. 

ENABLE INTR Sil 

! Then return to interrupted context. 

SUBEKIT 
END IF 
! 

SUBEND ! ********************************** 
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The service routine first enables two types of interrupts; one is generated when power is back 
after the powerfail, and the other is generated when approximately one second of battery 
power remains. Then, the service routine attempts to store the specified data. Notice that the 
service routine stores the data one item at a time so that either interrupt may be serviced while 
the data are being stored. 

If the Power-Is-Back interrupt is generated, the service routine ends and returns to the main 
program. You may want to expand the service routine to sense recurring power flutuations and 
to respond accordingly. If the One-Second-Left interrupt is generated, the program stores a 
message to show how much of the desired data have been stored. Keep in mind that once this 
interrupt is generated, the computer powers down, regardless of whether power is restored 
before the end of the one second. 
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Summary of Powerfail 
Status and Control Registers 

This section lists all STATUS and CONTROL registers of the Powerfail-Protection Interface, 
which is permanently assigned to interface select code 5. 

STATUS Register — Card Identification is always 5. 

CONTROL Register — Shut Down. Any non-zero value written to this register will turn off 
both battery and ac-line power to the computer, which conserves battery power after the 
service routine has finished responding to the powerfail. If ac-line power is on when this 
statement is executed, the computer will be turned back on in the normal powerup sequence. 



STATUS Register 1 

Most Significant Bit 








Powerfail Interrupt Cause 

Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Not Used 


One 

Second 

Left 


Power 

Is 
Back 


Power 

Has 

Failed 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



CONTROL Register 1 — Not Used. 



STATUS Register 2 — Interrupt Mask has bit definitions identical to the preceding register 
(Powerfail Interrupt Cause). 

CONTROL Register 2 — Not Used. 



STATUS Register 3 

Most Significant Bit 










Powerfail Status 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Failed 
Self 
Test 


Not Used 


One 

Second 

Left 


Currently 

Using 

Battery 


Ac 

Is 

Down 


In the 

Powerfail 

State 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit 7 — IFailed Self Test indicates the outcome of the self test: a 1 indicates failure, and 
indicates successful results. 

Bit 3 — One Second Left indicates that approximately one second of battery power remains. 
The computer will automatically power itself down, even if power is restored before one second 
has expired. 
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Bit 2 — Currently Using Battery indicates whether or not the battery is being used: 1 indicates 
it is currently being used for computer power, and indicates that it is not. 

Bit 1 — Ac Is Down indicates the current status of ac-line power: a 1 indicates that ac power is 
completely gone. If bit 2 is a 1 and this bit is 0, the battery is being used because ac power is not 
completely gone but has dropped below an acceptable level; in this case, a "brown-out" 
condition is indicated. 

Bit — In the Powerfail State indicates whether or not the computer is currently in the 
Powerfail State: a 1 indicates Powerfail State, and indicates that the computer is not currently 
in the Powerfail State. The Powerfail State is exited when power is back and the Power Back 
Timer reaches the value of the Power Back Delay. 

CONTROL Register 3 — Not Used. 



STATUS Register 4 — Overheat Protection Timer contains the amount of battery time used 
during this Powerfail State (in tens of milliseconds). For every second the power is down, it 
must be back for two seconds to ensure adequate cooling for the machine. Thus, the value of 
this register bounds the maximum amount of time that can be obtained from the battery, even 
though 60 seconds may have been specified as the protection time (CONTROL Register 6). 

CONTROL Register 4 — Not Used. 



STATUS Register 5 — Power Back Timer contains the time elapsed since power was restored 
after the last powerfail (in tens of milliseconds). 

CONTROL Register 5 — Power Back Delay. The value of this register determines the 
amount of time (in tens of milliseconds) that the computer will delay, after power is back, before 
leaving the powerfail state (i.e.. before generating a "Power Is Back" interrupt). The power-on 
default value is 50 (500 milliseconds). 



STATUS Register 6 — Powerfail Timer contains the time elapsed since the last powerfail (in 
tens of milliseconds). 

CONTROL Register 6 — Protection Time. The value of register determines the maximum 
amount of time (in tens of milliseconds) that the computer is to have battery backup. Power-on 
default is 6000 (60 seconds). 
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STATUS Register 7 — Not Used. 

CONTROL Register 7 — Powerfail Delay Timer. The contents of this register determine the 
amount of time (in tens of milliseconds) that the Powerfail-Protection Interface will wait, after a 
powerfail, before generating a "Power Has Failed" interrupt. Power-on default is 10 (100 
milliseconds). 



STATUS Registers 8 thru 71 — Continuous-Memory Registers contain the 64 bytes of data 
written by the last CONTROL statement directed to these registers. 

CONTROL Registers 8 thru 71 — Continuous-Memory Registers. These sixty-four, single- 
byte registers can be filled with any desired data, one byte (ASCII character) per register. 
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The GPIO Interface 



Chapter 



16 



Introduction 

This chapter should be used in conjunction with the HP 98622A GPIO Interface Installation 
manual. The best way to use these two documents is to read this chapter before attempting 
to configure and connect the interface according to the directions given in the installation 
manual. The reason for this order of use is that knowing how the interface works and how it is 
driven by BASIC programs will help you to decide how to connect it to your peripheral device. 
If you only need to use the interface to connect the computer to simple devices (such as 
printers), the examples at the end of the chapter (to be added) may be enough to "get you up 
and running". 

The HP 98622 Interface is a very flexible parallel interface that allows you to communicate with 
a variety of devices. The interface sends and receives up to 16 bits of data with a choice of 
several handshake methods. External interrupt and user-definable signal lines are provided for 
additional flexibility. The interface is known as the General-Purpose Input/Output (GPIO) 
Interface for these reasons. This chapter describes the use of the interface's features from 
BASIC programs. 

Use of some statements or suggestions for interfacing requires that you load the TRANS BIN 
file. 
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Interface Description 



The main function of any interface obviously to transfer data between the computer and a 
peripheral device. This section briefly describes the interface lines and how they function. Using 
the lines from BASIC programs is more fully described in subsequent sections. 



The GPIO Interface provides 32 lines for data input and output: 16 for input (DIO 
and 16 for output (DOO — D015). 



DI15), 



Backplane 
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Block Diagram of the GPIO Interface 

Three lines are dedicated to handshaking the data from source to destination device. The 
Peripheral Control line (PCTL) is controlled by the interface and is used to initiate data trans- 
fers. The Peripheral Flag line (PFLG) is controlled by the peripheral device and is used to signal 
the peripheral's readiness to continue the transfer process. The Input/Output line (I/O) is used 
to indicate direction of data flow. 



One line is used to signal External Interrupt Requests to the computer (EIR). The interface must 
be enabled to initiate interrupt branches for the interface to detect this request. The state of the 
line can also be read by the program. 

Four general-purpose lines are available for any purpose that you may desire; two are control- 
led by the computer and sensed by the peripheral (CTLO and CTLl), and two are controlled by 
the peripheral device and sensed by the computer (STIO and STIl). 

Both Logic Ground and Safety Ground are provided by the interface. Logic Ground provides 
the reference point for signals, and Safety Ground provides earth ground for cable shields. 
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Interface Configuration 

This section presents a brief summary of selecting the interface's configuration-switch settings. 
It is intended to be used as a checklist and to begin to acquaint you with programming the 
interface. Refer to the installation manual for the exact location and setting of each switch. 

The following sample program checks a few of these switch settings on a GPIO Interface 
already installed in the computer and displays the settings. However, many of the settings 
cannot be determined from BASIC programs. If any of the displayed settings are different than 
desired, or if any settings are not already known, refer to the installation manual for switch 
locations and settings. 

100 PRINTER IS 1 ! Select printer device* 

110 PRINT CHR$(12) ! Clear screen. 

120 ! 

130 DISP "Enter GPIO Interface Select Code (C0NT=12)" 

laO OUTPUT 2 USING "tt>DD";i2 

150 ENTER 2;isc 

ISO DISP 

170 ! 

180 ASSIGN iGpio TO Isc ! FORMAT ON default. 

190 ! 

200 ! Read STATUS registers and 1. 

210 STATUS Isc ;Card-id »Int r_5tat 

220 ! 

230 ! Is this card a GPIO? 

2a0 IF Card_id<>3 THEN 

250 PRINT "The interface at select code";isc 

2B0 PRINT "is not a GPIO Interface." 

270 PRINT "Program stopped." 

280 STOP 

230 ELSE 

300 PRINT "The card ID of the GPIO at" 

310 PRINT "interface select code"iIsc 

320 PRINT "is";Card_id 

330 END IF 

SaO PRINT 

350 ! 

3G0 i Calculate hardware interrupt priority. 

370 Gits_5_and_a = BINAND( Int r_s t at .32 + lG ) 

380 Switches=Bits_5_and_a DIV IB 

390 Hd_prio r=Switches+3 

400 PRINT "Hardware Interrupt Priority is";Hd_prior 

aiO PRINT 

420 ! 

430 END 
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Interface Select Code 

In BASIC, allowable interface select codes range from 8 through 31; codes 1 through 7 are 
already used for built-in interfaces. The GPIO interface has a factory default setting of 12, which 
can be changed by re-configuring the "SEL CODE" switches on the interface. 

Hardware Interrupt Priority 

Two switches are provided on the interface to allow selection of hardware interrupt priority. The 
switches allow hardware priority levels 3 through 6 to be selected. Hardware priority deter- 
mines the order in which simultaneously occurring interrupt events are logged, while software 
priority determines the order in which interrupt events are serviced by the BASIC program'. 

Data Logic Sense 

The data lines of the interface are normally low-true; in other words, when the voltage of a 
data line is low, the corresponding data bit is interpreted to be a 1. This logic sense may be 
changed to high-true with the Option Select Switch. Setting the switch labeled "DIN" to the 
"0" position selects high-true logic sense of Data In lines. Conversely, setting the switch labeled 
"DOUT" to the "1" position inverts the logic sense of the Data Out lines. The default setting is 
"1" for both. 

Data Handshake Methods 

This section describes the data handshake methods available with the GPIO Interface. A gener- 
al description of the handshake modes and clock sources is given first. A more detailed discus- 
sion of each handshake is then given to allow you to choose the handshake mode, clock source, 
and handshake-line logic sense that is compatible with your peripheral device. 

As a brief review, a data handshake is a method of synchronizing the transfer of data from the 
sending to the receiving device. In order to use any handshake method, the computer and 
peripheral device must be in agreement as to how and when several events will occur. With 
the GPIO Interface, the following events must take place to synchronize data transfers; the first 
two are optional. 

• The computer may optionally be directed to perform a one-time "OK check" of the 
peripheral before beginning to transfer any data. 

• The computer may also optionally check the peripheral to determine whether or not the 
peripheral is "ready" to transfer data. 

• The computer must indicate the direction of transfer and then initiate the transfer. 

• During OUTPUT operations, the peripheral must read the data sent from the computer 
while valid; similarly, the computer must clock the peripheral's data into the interface's 
Data In registers while valid during ENTER operations. 

• The peripheral must acknowledge that it has received the data. 

Handshake Lines 

The GPIO handshakes data with three signal lines. The Input/Output line, I/O, is driven by 
the computer and is used to signal the direction of data transfer. The Peripheral Control line, 
PCTL, is also driven by the computer and is used to initiate all data transfers. The Peripheral 
Flag line, PFLG, is driven by the peripheral and is used to acknowledge the computer's requests 
to transfer data. 
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Handshake Logic Sense 

Logic senses of the PCTL and PFLG lines are selected with switches of the same name. The 
logic sense of the I/O line is High for ENTER operations and Low for OUTPUT operations; this 
logic sense cannot be changed. The available choices of handshake logic sense and handshake 
modes allow nearly all types of peripheral handshakes to be accommodated by the GPIO 
Interface. 

Handshake Modes 

There are two general handshake modes in which the PCTL and PFLG lines may be used to 
synchronize data transfers: Full-Mode and Pulse-Mode Handshakes. If the peripheral uses 
pulses to handshake data transfers and meets certain hardware timing requirements, the Pulse- 
Mode Handshake may be used. The Full-Mode Handshake should be used if the peripheral 
does not meet the Pulse-Mode timing requirements. 

The handshake mode is selected by the position of the "HSHK" switch on the interface, as 
described in the installation manual. Both modes are more fully described in subsequent 
sections. 

Data-in Clock Source 

Ensuring that the data are valid when read by the receiving device is slightly different for 
OUTPUT and ENTER operations. During OUTPUTS, the interface generally holds data valid 
while PCTL is in the Set state, so the peripheral must read the data during this period. During 
ENTERS, the data must be held valid by the peripheral until the peripheral signals that the data 
are valid (which clocks the data into interface Data In registers) or until the data is read by the 
computer. The point at which the data are valid is signalled by a transition of PFLG. The PFLG 
transition that is used to signal valid data is selected by the "CLK" switches on the interface. 
Subsequent diagrams and text further explain the choices. 

Optional Peripheral Status Check 

Many peripheral devices are equipped with a line which is used to indicate the device's current 
"OK-or-Not-OK" status. If this line is connected to the Peripheral Status line (PSTS) of the 
GPIO Interface, and the computer may determine the status of the peripheral device by check- 
ing the state of PSTS. The logic sense of this line may be selected by setting the "PSTS" switch. 

If enabled, the computer performs a one-time check of the Peripheral Status line (PSTS) 
before initiating any transfers as part of the data-transfer handshake. If PSTS indicates "Not 
OK," Error 172 is reported; otherwise, the transfer proceeds normally. If this feature is not 
enabled, this one-time check is never made. This feature is available with both Full-Mode and 
Pulse-Mode Handshakes. See "Using the PSTS Line" for further details. 

Full-Mode Handshakes 

The Full-Mode Handshake mode is described first for two reasons. The first reason is that the 
PCTL and PFLG transitions must always occur in the order shown, so only one sequence of 
peripheral handshake responses needs to be shown. Secondly, this mode will generally work 
when the Pulse-Mode Handshake may not be compatible with the peripheral's handshake 
signals. The Pulse-Mode Handshake is described in the next section. 
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The following diagrams show the order of events of the Full-Mode OUTPUT and ENTER 
Handshakes. These drawings are not drawn to any time scale: only the order of events is 
important. The I/O line has been omitted to simplify the diagrams; in all cases, it is driven Low 
before any OUTPUT is initiated by the computer and High before any ENTER is initiated. 
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Diagram of Full-Mode OUTPUT Handshakes 



With Full-Mode Handshakes, the computer first checks to see that the peripheral device is 
Ready before initiating the transfer of each byte/word (tO); with this handshake mode, the 
peripheral indicates Ready when both PCTL is Clear and PFLG is Ready. If the peripheral 
does not Indicate Ready, the computer waits until a Ready is indicated. 

When a Ready is sensed, the computer places data on the Data Out lines (tl) and drives the I/O 
line Low (not shown). The interface then waits the PCTL Delay time before initiating the 
transfer by placing PCTL in the Set state (t2). 

The peripheral acknowledges the computer's request by placing the PFLG line Busy (t3); this 
PFLG transition automatically Clears the PCTL line (t4). However, the computer cannot inti- 
tate further transfers until the peripheral is Ready with Full-Mode Handshake; the peripheral is 
not Ready until both PCTL is Clear and PFLG is Ready (t5). 

The data on the Data Out lines is held valid from the time PCTL is Set until after the peripheral 
indicates Ready. The peripheral may read the data any time within this time period. 

The PCTL and PFLG lines are used in the same manner in Full-Mode ENTER Handshakes as in 
Full-Mode OUTPUT Handshakes. However, there are three options available as to when the 
peripheral's data may be valid; at the Ready-to-Busy transition of PFLG (BSY clock source), at 
the Busy-to-Ready transition of PFLG (RDY clock source), and when the Data In lines are read 
with a STATUS statement (READ clock source). The first two of these options are shown in the 
following two diagrams; the READ clock source is discussed later in "Designing Your Own 
Transfers". 
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Full-Mode ENTER Handshake with BSY Clock Source 

As with Full-Mode OUTPUT Handshakes, the computer first checks to see if the peripheral is 
Ready (tO); since PCTL is Clear and PFLG is Ready, the handshake may proceed. The compu- 
ter places the I/O line in the High state (not shown) and then initiates the handshake by placing 
PCTL in the Set state (tl). 

With the "BSY" clock source, the PFLG transition to the Busy state clocks the peripheral's data 
into the interface's Data-in registers; consequently, the peripheral must place data on the 
Data-in lines (t2), allowing enough time for the data to settle before placing PFLG in the Busy 
state (t3). This PFLG transition to the Busy state automatically Clears PCTL (t4). The next 
handshake may be initiated when PFLG is placed in the Ready state by the peripheral (t5). 
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Full-Mode ENTER Handshake with RDY Clock Source 



As with other Full-Mode Handshakes, the computer first checks to see if the peripheral is ready 
(tO). Since PCTL is Clear and PFLG is Ready, the computer may drive the 1/0 line High (not 
shown) and initiate the handshake by placing PCTL in the Set state (tl). 

The peripheral may acknowledge by placing PFLG Busy (t2), which automatically Clears PCTL 
(t3). Unlike the previous example, this transition does not clock data into the interface Data-in 
registers. With the "RDY" clock source, the peripheral must place the data on the Data-in lines 
(t4), allowing enough time for the data to settle before placing PFLG in the Ready state (t5). 
The computer may then initiate a subsequent transfer. 

Pulse-Mode Handshakes 

The following drawings show the order of handshake-line events during F'ulse-Mode Hand- 
shakes. Notice that the main difference between Full-Mode and Pulse-Mode Handshakes is 
that the PFLG is not cfiecked for Ready before the computer initiates Pulse-Mode Hand- 
shakes; the computer may initiate a subsequent data transfer as soon as the PCTL line is 
Cleared by the Ready-to-Busy transition of PFLG. 

Two cycles of data transfers are shown in these diagrams to illustrate that the computer need 
not wait for the PFLG = Ready indication with the Pulse-Mode Handshake. The first cycle 
shown in each diagram is a typical example of the first transfer of an 1/0 statement. The dashed 
PFLG line at the beginning of the second cycle shows that computer disregards whether or not 
PFLG is in the Ready state before the next transfer is initiated. 

This absense of the PFLG check allows a potentially higher data-transfer rate than possible 
with the Full-Mode Handshake; however, in some cases, it also places additional timing restric- 
tions on the peripheral's response time, as described in the text. 
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Busy Pulses With Pulse-Mode OUTPUT Handshake 

The PFLG line is not checked for Ready before the computer drives the I/O line Low (not 
shown) and places data on the Data-Out lines (tl). A PCTL Delay time later, the interface 
initiates the transfer by placing PCTL in the Set state (t2). 

The peripheral acknowledges by placing PFLG Busy (t3); this transition automatically Clears 
PCTL (t4). The dashed PFLG line shows that the computer may initiate another transfer any 
time after PCTL is Clear, possibly before the peripheral places PFLG in the Ready state (t5). 

The Busy Pulse shown in the diagram is identical to the PFLG's response during the previous 
Full-Mode handshake; however, the Pulse-Mode Handshake works properly with this type of 
pulse only if the peripheral reads the data by the time PCTL is Clear (data should be read 
between t2 and t3). If the peripheral has not read the data by the time that PCTL is Clear, it 
might erroneously read the data for the second transfer, since the computer might have already 
changed the data and initiated the second transfer. 
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Busy Pulses With Pulse-Mode ENTER Handshakes (BSY Clock Source) 

The computer does not have to check for PFLG to be Ready before placing I/O in the High state 
(not shown) and initiating the transfer by placing PCTL in the Set state (tl). 

The peripheral must place data on the Data In lines (t2), allowing enough time for the data to settle 
before placing PFLG in the Busy state (t3). This Ready-to-Busy transition of PFLG automatically 
Clears PCTL. The dashed PFLG signal shows that the next transfer may be initiated before PFLG 
indicates Ready. 
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Busy Pulses With Pulse-Mode ENTER Handshakes (RDY Clock Source) 

The computer does not have to check for PFLG to be Ready before placing 1/0 in the High state 
(not shown) and initiating the transfer by placing PCTL in the Set state (tl). 

The peripheral must place data on the Data In lines (t2), allowing enough time for the data to 
settle before placing PFLG Busy (t3). This requirement may seem contradictory, since the 
clock source is the Busy-to-Ready transition of PFLG. However, with Pulse-Mode handshakes, 
the peripheral is assumed to be Ready whenever PCTL is Clear; consequently, the computer 
may read the data any time after PCTL is cleared by the Ready-to-Busy transition of PFLG. The 
PFLG transition to Busy Clears PCTL (t4), after which the peripheral may place PFLG Ready 
(t5). 



Note 

In order to use this type of pulse with the Pulse-Mode Handshake 
and RDY clock source, the peripheral must adhere to the stated 
timing restrictions. 
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Ready Pulses With Pulse-Mode OUTPUT Handshakes 

The PFLG line is not checked for Ready before the computer drives the I/O line Low (not 
shown) and places data on the Data Out lines (tl). A PCTL Delay time later the interface 
initiates the transfer by placing PCTL in the Set state (t2). 

The peripheral later acknowledges by placing PFLG in the Ready state (t3). The handshake is 
completed by the peripheral placing PFLG in the Busy state (t4), which automatically Clears 
PCTL (t5). 

If the peripheral uses the type of Ready pulses shown, either the Pulse-Mode handshake with 
default PFLG logic sense or Full-Mode handshake with inverted PFLG logic sense may be used. 
With this type of pulse, the data being output may be read by the peripheral as long as PCTL is 
Set. 
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Ready Pulses With Pulse-Mode ENTER Handshakes (BSY Clock Source) 

The computer does not have to check for PFLG to be Ready before placing I/O in the High state 
(not shown) and initiating the transfer by placing PCTL in the Set state (tl). 

The peripheral acknowledges by placing PFLG in the Ready state (t2). The peripheral must 
place data on the Data In lines (t3), allowing enough time for the data to settle before placing 
PFLG in the Busy state (t4). With this type of pulse, events t2 and t3 may also occur in the 
reverse order. 

The Ready-to-Busy transition of PFLG automatically Clears PCTL (t4). The dashed PFLG 
signal shows that the state of PFLG is not checked before the computer initiates a subsequent 
transfer. 
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Ready Pulses With Pulse-Mode ENTER Handshakes (RDY Clock Source) 

The computer does not have to check for PFLG to be Ready before placing I/O in the High state 
(not shown) and initiating the transfer by placing PCTL in the Set state (tl). 

The peripheral must place data on the Data In lines (t2), allowing enough time for the data to 
settle before placing PFLG Ready (t3). The peripheral places PFLG in the Busy state (t4), which 
automatically Clears PCTL (t5). 
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Interface Reset 

The interface should always be reset before use to ensure that it is in a known state. All 
interfaces are automati cally reset by the computer at certain times: when the computer is 
powered on, when the ( RESET) key is pressed, and at other times described in the Reset Table'. 
The interface may be optionally reset at other times under control of BASIC programs. Two 
examples are as follows: 

Gpio = 12 

CONTROL Gpio »0;i 

Reset = l 

CONTROL GpioiReset 

The following action is invoked whenever the GPIO Interface is reset: 

• The Peripheral Reset line (PRESET) is pulsed Low for at least 15 microseconds. 

• The PCTL line is placed in the Clear state. 

• If the DOUT CLEAR jumper is installed, the Data Out lines are all cleared (set to logic 0). 

• The interrupt enable bit is cleared, disabling subsequent interrupts until re-enabled by the 
program. 

The following lines are unchanged by a reset of the GPIO Interface: 

• The CTLO and CTLl output lines. 

• The I/O line. 

• The Data Out lines, if the DOUT CLEAR jumper is not installed. 



1 The Reset Table is given in the Useful Tables of the BASIC Language Reference. 
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Outputs and Enters through the GPIO 

This section describes techniques for outputting and entering data through the GPIO Interface. 
The mechanism by which data are communicated are the electrical signals on the data lines. 
The actual signals that appear on the data lines depend on three things: the data currently being 
transferred, how this data is being represented, and the logic sense of the data lines. 

Brief explanations of ASCII and internal data representation are given in Chapter 2. Complete 
details of the freefield convention and effects of IMAGE specifiers during OUTPUT and ENTER 
statements are described in Chapters 4 and 5, respectively. The section of Chapter 10 called 
"The FORMAT OFF Attribute" describes how internal-form data are represented during OUT- 
PUT and ENTER. This section gives simple examples of how several representations are im- 
plemented during OUTPUTs and ENTERs through the GPIO Interface. 

ASCII and Internal Representations 

When data are moved through the GPIO Interface, the data are generally sent one byte at a 
time, with the most significant byte first. This byte-mode transfer is independent of whether 
FORMAT ON or FORMAT OFF is the I/O path attribute. However, there are two exceptions; 
data are represented by words when the "W" image specifier is used and when numeric data 
are moved with reads of STATUS register 3 and writes to CONTROL register 3. The following 
diagrams illustrate which data lines are used during byte and word transfers. 
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Only lower 8 bits are used. 



Diagram of Byte Transfers 

Example Statements that Output Data Bytes 

The following diagrams show the actual logic signals that appear on the least significant data 
byte (D07 thru DOO) as the result of the corresponding OUTPUT statement; the most signifi- 
cant byte is always zeros with byte transfers. The actual logic levels depend on how the data 
lines are configured (i.e., as Low-true or High-true). 
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ASSIGN O^Gpio TO 12;F0RMAT 
IriteSe r.-l =25B*85 + 7B 
OUTPUT GiGpio ;irite3er_l 
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ASSIGN G'Gpio TO 12;F0RMAT OFF 
St r in ^$="1234" 
OUTPUT G!Gpio ;StrinS$ 
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Example Statements that Enter Data Bytes 

The following diagrams show the variable values that result from the logic signals being present 
during the corresponding ENTER statement on the least significant data byte (D17 thru DIO); 
the most significant byte is always ignored with byte transfers. The actual logic levels required 
depend on how the data lines are configured (i.e., as Low-true or High-true). 



ENTER @Gpio USING "w»B";Byte 
DISP "Malue en t e red = " ?By t e 
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REAL Number 
ASSIGN @Gpio TO 12 
ENTER @Gpio JNumbe r 
DISP "Nu(riber=" 5 Number 

N u m b e r = 2 
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Upper 8 bits are used only when: 

1 . Writing to CONTROL register 3 
(reading from STATUS register 3). 

2. The "W" image specifier is used. 



Lower 8 bits are used for ALL data 
transfers. 



Diagram of Word Transfers 

Example Statements that Output Data Words' 

The following diagrams show the logic signals that appear on the Data Out lines as a result of 
the corresponding BASIC statements and numeric values. All numeric values are first rounded 
to an INTEGER value before being placed on the Data Out lines. The actual logic level that 
appears on each line depends on how the lines have been configured (i.e., as High-true or 
Low-true). 



Word=3*25B+3 
OUTPUT @GpiQ 



USING "« fW" 50utput_word 



Signal Lines 
DOS D07 



D015 DOS D07 DOO 

000 011 0000 0011 



0utPut_lB_bit5=-l 
CONTROL Gp_i5C >3 ;0utput. 



IB-bits 



Signal Lines 
D015 DOS DO? 



DOO 



11111111 11111111 



It is important to note that no output handshake is executed when the CONTROL statement is 
executed; only the states of the Data Out lines and the I/O line are affected. Handshake 
sequence, if desired, must be performed by BASIC statements in the program. See "Designing 
Your Own Transfers" for design suggestions. 

1 Data are automatically sent as words when using an I/O path with the WORD attribute. See Chapter 10 for further information. 
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Example Sitatements that Enter Data Words' 

The following diagrams show the variable values that result from entering the logic signals on 
the Data In lines. Note that all sixteen-bit values entered are interpreted as INTEGER values. 



Signal Lines 
DI15 DI8 DI7 DIO 

0000 0001 1111 1111 



ENTER 12 USING " » » W " ! En t e r_ 1 B_b i t s 
DISP "INTEGER en t e r e d = " 5En t e r_l B_b i t s 

INTEGER entered= 511 



Signal Lines 
DI15 DI8 DI7 DIO 

1111 1110 0000 0000 



STATUS Gp_isc j3 JEnte r_lG_bits 

DISP "INTEGER en t e re d= " ;En t e r_l B_b i t s 

INTEGER entered= -512 

It is important to note that no enter handshake is performed when the STATUS statement is 
executed. The only actions taken are the I/O line being placed in the High state and the Data In 
registers being read. If an enter handshake is required, it must be performed by the BASIC 
program. See "Designing Your Own Transfers" for design suggestions. 

Remember also that the Data In Clock source is solely determined by the switch setting on the 
interface card. Thus, when the STATUS statement is used to read the Data In lines, the data on 
the lines may or may not be clocked into the registers when the statement is executed. If the 
data are to be clocked in by the STATUS statement, the "READ" clock source must be 
selected. See the installation manual for further details. 

GPIO Timeouts 

Timeout events were generally discussed in Chapter 7. However, specific details of the affects 
of the time parameter on the event's occurrence were not described. This section explains how 
the time parameter is measured and describes typical service routines. 

Timeout Time Parameter 

There are two general time intervals measured and compared to the specified TIMEOUT time. 
The first interval is measured between the computer initiating the first handshake (PCTL = Set) 
and the peripheral signalling Ready (with the PFLG line). If the peripheral does not indicate 
readiness^ by the specified TIMEOUT time parameter, a TIMEOUT event occurs. 

The time elapsed during each handshake is also measured and compared to the TIMEOUT 
time. The timing begins when the transfer is initiated (PCTL Set by the computer) and, in 
general, ends when the peripheral responds on the PFLG line. 

1 Data are automatically received as words when using an I/O path with the WORD attribute. See Chapter 10 for further information. 

2 The computer optionally reads the state of the PSTS line before initiating the transfer. See "Using the PSTS Line" for further details. 
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Keep in mind that the TIMEOUT time parameter specifies the minimum time that the computer 
will wait before initiating the ON TIMEOUT branch. However, the computer may occasionally 
wait an additional 25% of the specified time parameter before initiating the branch. For inst- 
ance, if a time of 0.4 seconds is specified, the computer will wait at least 4 seconds for the 
handshake to be completed, but it may occasionally wait up to 0.5 seconds before initiating the 
ON TIMEOUT branch. 

Timeout Service Routines 

The service routine usually responds by determining if the peripheral is functioning properly 
("OK") or is down ("not OK"). The simplest action that might be taken by the computer is to 
read the state of the PSTS signal line, as shown in the following service routine. 

100 G p i = 1 2 

110 ON TIMEOUT Gpiot.08 GOSUB Gpio.down 

200 OUTPUT Gpio ;St rim S$ 
210 ! Next line. 

300 Gpio_down: STATUS Gpi o >5 ; Pe r i ph_s t at us 

e riph_status »3) ! Read PSTS. 
Psts THEN 
"GPIO interface is " 
" n n - f Li n c t i n a 1 " 
" P ro S rait) paused." 



other action. 



A TIMEOUT has been set up to occur if the peripheral takes approximately more than .08 
second to complete its response during a data transfer; how the peripheral completes its 
response depends on the handshake mode currently selected. With Pulse-Mode Handshakes, 
the peripheral completes its response by using PFLG to Clear PCTL; with Full-Mode Hand- 
shakes, the response is complete only after PCTL has been Cleared and PFLG is in the Ready 
state. 

When a TIMEOUT occurs, the computer automatically executes an Interface Reset; the 

PCTL line is Set and then Cleared, and the PRESET line is pulsed Low. See the section called 
"Interface Reset" for further effects. The Service routine checks the PSTS line to see if the 
peripheral is OK or not OK. If not OK, a message is displayed and the program is paused; if OK, 
program execution is returned to the line following that in which the TIMEOUT occurred. 
Service routine may be programmed to attempt the transfer again, if desired; however, the 
automatic Reset performed when the TIMEOUT occurred may make this type of response 
difficult to implement. 



310 




P5t5=BIT 


320 




IF NOT P 


330 




PRINT 


340 




PRINT 


350 




PRINT 


3G0 




PAUSE 


370 




ELSE 


380 




! Take 


330 




END IF 


400 


RETURN 
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Using Alternate Data Representations 

As with any other interface, representations other than the ASCII or internal representations 
may sometimes be more meaningful to the peripheral. This section briefly describes a few 
techniques for implementing alternate data representations. 

BCD Representation 

With OUTPUT and ENTER statements, numeric values are either represented by ASCII characters 
or by one of the internal representations (INTEGER or REAL). Another common method of 
representing numeric data is to use four-bit, binary-coded decimal (BCD) characters. Only ten of 
the available sixteen bit patterns need to be used to represent decimal digits "0" through "9". The 
remaining six patterns can be used for sign, decimal point, exponent, and other special characters, 
as required by the application. 

The following bit patterns have been chosen arbitrarily to correspond to numeric characters'. 
Note that this representation cannot be used if more than six other characters are to be 
represented. 



Decimal 


Bit Pattern 


Other 


Bit Pattern 


Digit 


MSB 






LSB 


Character 


MSB 


LSB 

















Line-Feed 


1 


1 


1 











1 


-1- 


1 


1 1 


2 








1 







1 1 





3 








1 


1 


— 


1 1 


1 


4 





1 








E 


1 1 


1 


5 





1 





1 




1 1 


1 1 


6 





1 


1 











7 





1 


1 


1 








8 


1 

















9 


1 








1 









The following subprogram assumes that BCD numbers are to be entered through the GPIO 
Interface. Sixteen BCD characters are represented by four 16-bit words from the peripheral. 
The sixteen four-bit BCD characters have the following general format. 



Mantissa sign 


Mantissa 


"E" 


Exponent sign 


Exponent 



1 

(optional) 



Up to 16 
(at least one) 



1 
(optional) 



1 
(optional) 



Up to 3 
(optional) 



1 This is also the data representation used by the HP 98623 BCD Interface. See Chapter 17 for further information. 
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Each BCD character is represented by four bits of data. The first word entered contains the four 
most significant BCD characters, and the last word contains the least significant. The program 
changes the BCD characters to their ASCII representation and then uses the number builder to 
generate the corresponding numeric value. 



10 
11 
12 
13 

la 

15 
IB 
17 
18 
13 
20 
21 

23 

2a 

25 

26 

27 

28 

29 

30 

31 

32 

33' 

34 

35 

3G 

37 

38 

39 

ao 



ASSIGN @Gpio ID 12 
I 

! Define c o n i.i e r s i o n string. 

Coriu$="012345G789"6:CHR$( 1 ) & " + ,-E. " 
! 

CALL E n t e r _ b c d ( @ G p i a > C o rn.i $ » N u (ii b e r ) 

OUTPUT ir'The BCD number is "JNiunber 
! 

END 

! 

! 

SUB E n t e r _ b c d ( d D e i.) i c e j E o n u $ » N u m b e r ) 
COM /Enter_bcd/ INTEGER Word(l:4) 
! 

! Enter a words (=16 BCD dibits), 

ENTER iDeuice USING " « » W " 5 No r d ( * ) 
i 

FOR W=l TO 4 ! Process four words. 
! 

! Shift risht multiples of four bits, 
FOR Bits_rt=12 TO STEP -4 

Shifted_word=SHIFT(Word(N)»Bits_rt) 



Four_lsb = BINANDCShif ted_wo rd »15) 
A s c i i _ c h a r $ = C n u $ C F u r _ 1 s b + 1 ; 1 ] 
Numbe r$ = Nufflbe r$6:Asc i i_cha r$ 

NEXT Bits_rt 

! 

NEXT W 
! 

ENTER N u m b e r $ 5 N u m b e r ! Use n u m b e r builder. 
SUBEND ! Returns BCD number as "Number". 



! MasK MSB's. 
LSB's = index. 
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Character Conversions 

One of the most common needs of a computer is to convert' certain unused or disallowed bit 
patterns into meaningful or allowed bit patterns. A typical example is to change the radix 
character from a decimal point to a comma. For instance, the following ASCII characters 
represent the same number. 



U.S. Representation 



1,234,567.89 



European Representation 



1.234.567,89 



A remedy is needed to allows these types of numbers to be entered through the number 
builder. To enter a number with the preceding European format, the commas must be changed 
to periods and the periods changed to spaces. The following routine changes the numeric radix 
from the European to the US convention when numeric data are entered through the GPIO. 

100 ! Generate string with no conversions. 

110 DIM Conu$[25G] 

120 FOR Code=0 TO 255 

130 Conu$CCode+l ]=CHR$(Code ) 

lao NEXT Code 

150 ! 

1 G ! Then define the c o n u e r s i o n s . 

170 Cong$CNUM< " . " ) + l ;i] = " " ! Change "." to " " 

180 i:onu$CNUM( " »" ) + l ;i] = " . " ! Change " f" to "," 

190 ! 

200 ! 

2 1 N umb e r$ = " 1 23 . aSB » 789 " 

220 PRINT "Before conuersion "5 Number* 

230 CALL Conue Ft ( ConM$ jNurnbe r$ ) 

2a0 PRINT "After conversion "iNumbert 

250 ! 

2B0 END 

270 ! 

280 ! 

290 SUB Conue rt (Conu* »Data$ ) 

300 ! 

310 FOR Char_POS=l TO LEN(Data$) 

320 Index=NUM(Data$CChar_P05] )+l 

330 Data$CChar_pos;i]=Coni.i$CIndex;i] 

3a0 NEXT Char_Pos 

350 ! 

3G0 ! Returns Data$ with converted characters. 

370 SUBEND 

If more characters are to be converted, simply change the default (standard ASCII) character in 
Conv$ to the desired code. The speed of the conversion is not affected by the number of 
characters to be converted. This routine works for either input or output, but the characters to 
be converted must be in a string variable. 

1 This is also the data representation used by the HP 98623 BCD Interface. See Chapter 17 for further information. 
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GPIO Interrupts 



This section describes the types of and techniques for using the interrupts available on the 
GPIO Interface. 

Types of Interrupt Events 

The GPIO Interface can sense two interrupt events: the first is the interface becoming "Ready" for 
subsequent handshakes, and the second is the External Interrupt Request line (EIR) being driven to 
logic low by the peripheral. As with all interfaces, both events initiate identical computer 
responses — the service routine must be able to determine which of these interrupts have occurred 
if both are enabled to initiate interrupts. 

Both of these types of interrupt events are level-sensitive; in other words, the signal that 
caused the event should be maintained until the program has time to determine which event 
has caused the interrupt. Further explanation follows in this section. 

Setting Up and Enabling Events 

When either event occurs, the interrupt is logged by the BASIC operating system. After logging 
the occurrence, any further interrupts from the GPIO Interface are automatically disabled until 
specifically enabled by a program. All further computer responses to either event depend 
entirely on the BASIC program currently in memory. 

The following program segment shows the steps involved in setting up and enabling Ready 
interrupts. 

100 Gpio=12 

110 ON INTR Gpio GOSUB Gpio_5eru 

120 ! 

130 MasK=2 

lao ENABLE INTR GpioSMask 

The value of the interrupt mask determines which, if any, of the GPIO interrupt events are to be 
enabled to initate the corresponding branch. Bits of the Interrupt Mask register have the 
following definitions. 



Interrupt Enable Register 

Most Significant Bit 








(ENABLE INTR) 

Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Not Used 


Enable 
Interface 

Ready 
Interrupts 


Enable 

EIR 

Interrupts 


Value = 128 


Value - 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value - 2 


Value = 1 
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Interface Ready — Setting this bit (1) enables an interrupt to initiate the ON INTR branch 
when the interface detects that it is Ready to handshake data. If Full-Mode Handshake is 
selected (with the Option Select switch), the Ready event is PCTL = Clear and PFLG = Ready. 
With Pulse-Mode Handshake, the event is PCTL = Clear (independent of the state of PFLG). 

External Interrupt Request — Setting this bit (1) enables an interrupt to initiate the ON INTR 
branch when the interface senses an External Interrupt Request (EIR line = Low). 

Interrupt Service Routines 

If both events are enabled, the service routine must be able to differentiate between the two. 
And, if both have occurred, the service routine must be able to service both causes. The 
following registers contain the current state of the Interface Ready flag and EIR signal lines, 
from which the interrupt cause(s) may be determined. 

Status Register 4 - Interface Ready 

Interface is ready for a subsequent data transfer; 1 = Ready, 1 = Busy. 



Status Register 5 

Most Significant Bit 










Peripheral Status 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 














PSTS 
Ok 


EIR 
Line Low 


STI1 
Line Low 


STI0 
Line Low 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



As mentioned in preceding paragraphs, these two interrupt causes are both level-sensitive 
events, not edge-triggered events. This fact has two important implications. The first is that, 
for an event to be recognized, the corresponding signal line must be held in the interrupting 
state until the computer can interrogate the line's logic state. If the signal line's state is changed 
before the service routine checks the line, the interrupt may be "missed". This will happen only 
if both events are enabled; if only one event is enabled, determining the cause may not be 
necessary. 

The second implication is that the service routine must be able to acknowledge the request in 
order for the peripheral device to remove the request. If the request is not removed after 
service, the same request may be serviced more than once. 
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The following program shows a simple example of servicing an External Interrupt Request. 
Note that only ElR-type interrupts have been enabled and that the peripheral device provides 
its own interrupt cause with signals on the STIO and STIl lines. 



1 
110 
120 
130 

i<ao 

150 
ISO 
170 
IBO 
190 

2 
210 
220 
230 
2^0 
250 
2G0 
270 
280 
290 

3 
310 
320 
330 
340 
350 
3B0 
370 
380 
390 
400 
410 
420 
430 
440 
450 
4G0 
470 
480 
490 
5 
510 
520 
530 
540 



PRINTER IS 1 

Gpio=12 

CONTROL Gpioil ! Reset Interface. 
! 

ON INTR Gpio GOSUB Gpio.seru 

ENABLE INTR GpioU ! Enable EIR-type only. 
I 

! Show concurrent processing. 

Loop: C o u n t e r = C o u n t e r + 1 

DISP Counter 

GOTO Loop 
! 

STOP 
! 

Gpio_seru: ! 

STATUS Gpio>5;Periph_status ! ChecK EIR line. 

IF BIT(Periph_statU5»2) THEN ! EIR interrupt. 
! 

IF BIT( Pe riph_status >0) THEN ! STI0=True. 

BEEP 

PRINT "Improper Dalue! type in correct" 

PRINT "ualue* and press ENTER." 

PRINT 

ENTER 2;0alue 

OUTPUT Gpio ;Malue 
END IF 
I 

IF BIT(Periph_status »1 ) THEN ! STIl^True. 
BEEP 

PRINT "Reading o f : " ; Re ad i n ^ ? " out of raniJe' 
PRINT "No other action will be taken." 
PRINT 
WAIT 2 
BEEP 

END IF 
! 

END IF 



Put Ready service routine here. 



ENABLE INTR Gpio 

RETURN 

! 

END 



! Use same mask. 
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A slightly different method that peripherals use to communicate the cause of their interrupt 
request is to place the interrupt cause on the data lines concurrent with the interrupt request. 
The service routine can determine the cause by reading STATUS register 3 and take the 
appropriate action. 

Notice that the service routine indicates a likely place for a Ready-interrupt service routine. The 
Service routine must check for the Ready condition, acknowledge the interrupt, and then take 
the desired action. In this case, no service action has been defined because Ready interrupts 
have not been enabled. The next section provides an example of a Ready interrupt service 
routine. 

Designing Your Own Transfers 

Other specialized methods of handshaking data can be designed according to your specific 
needs. The methods of synchronizing data transfers are as flexible as the GPIO Interface 
hardware. However, the general techniques will probably still require the fundamental hand- 
shake features: initiation by the sending device, acknowledgement from the receiving device, 
and agreement as to when the data are valid. The TRANSFER statement can be used to transfer 
data. See Chapter 1 1 for further information. 

A wide choice of initiating events is available; obvious possibilities include use of the PCTL, 
EIR, or CTLO (or CTLl) lines to signal the start of the transfer. Data can be placed on the Data 
Out lines by writing to CONTROL register 3, or data can be clocked into the Data In registers by 
reading STATUS register 3. Sensing acknowledgement from the peripheral can be accom- 
plished by reading the state of such lines as PFLG, PSTS, EIR, or STIO (or STIl). 

The feature common to all of these methods is that each byte (or word) of data must be 
transferred individually. If an entire block of data is to entered or output, the BASIC program 
that implements the transfer must keep a "pointer" to which byte/word is to be transferred. 



402 The GPIO Interface 



Full Handshake Transfer 

The following program implements a handshake similar to the Full OUTPUT Handshake by 
controlling the PCTL and sensing the PFLG and PCTL lines. Timeout capability can easily be 
included in the routine, if so desired. 



100 DATA G5 »GG fG7 »GB >B3 

110 ! 

120 STATUS 12 t5;Pe riph_5tatus ! Chech PSTS. 

130 IF BIT(Periph_5tatU5 »3) THEN ! PSTS True, 

lao ! 

150 FOR Char=l TO 5 

IGO READ Code 

170 Wait: STATUS 1 2 t^ ! I n t e rf ac e_ re ad y 

100 IF NOT Interface- ready THEN Wait 

190 Output: CONTROL 12»3;Code ! Data onto lines. 

200 CONTROL 12,15 1 ! Set PCTL. 

210 NEXT Char 

220 ! 

230 ELSE ! PSTS False. 

240 PRINT "Peripheral error" 

250 PAUSE 

2G0 END IF 

270 ! 

280 END 

Notice that each byte of data must be output separately and that the program must keep track of 
which byte, of several, is to be sent. Keep in mind that the data written to CONTROL register 3 is 
16-bit words; in this case, the most significant eight bits (byte) is all zeros. Also, using FOR.. .NEXT 
loops to index each byte/word to be sent may not be the most expedient way of sending data, so 
your particular application may use alternative methods for handling the data. 

The following subprogram implements a handshake similar to the Full ENTER handshake. 

170 SUB En t e r_wo rd ( @De M i c e »Dat a_wo rd ) 

100 ! 

190 Waitl: STATUS 1 2 t4 5 I n t e r f ac e_ r e ad y 

200 IF NOT Interface-ready THEN Waitl 

210 STATUS 12 ,3 ;Dummy-read ! I/O Hi3h. 

220 CONTROL 12ti;i ! Set PCTL. 

230 Wait2: STATUS 1 2 >a 5 I n t e rf ac e_ re ad y 

2a0 IF NOT Interface-ready THEN Wait2 

250 STATUS 1 2 ,3 5 Dat a_wo rd ! Enter word. 

2G0 ! 

270 SUBEND 

The appropriate Data-in Clock source should be selected to ensure the data are clocked into 
the registers when valid. Refer to the installation manual for further details. 



The GPIO Interface 403 



Interrupt Transfers 

The interrupt capabilities of the GPIO Interface can be used to synchronize the transfer of data 
between the computer and peripheral. These examples describe simple methods of synchroniz- 
ing the transfer of data by using both the EIR and the PFLG line. See the section of this chapter 
called "GPIO Interrupts" for further explanation of GPIO interrupts in general. 

General interrupt transfers through the GPIO Interface involve the following elements: 

• placing data on (or reading data from) the data lines 

• signaling to the peripheral device to initiate the transfer 

• continuing processing until an interrupt is received, at which time the handshake is finished 
and transfer of the next byte/word can be initiated. 

Examples of using Ready interrupts to implement interrupt transfers are given in the remainder 
of this section. 

Ready Interrupt Transfers 

The Ready interrupt event occurs when the GPIO Interface becomes "Ready". Whether or not 
the GPIO Interface is Ready depends on the currently selected handshake mode. If Full-Mode 
Handshake is selected, the interface is Ready if both the PFLG line is Ready and the PCTL line 
is Clear; if Pulse-Mode is selected, the interface is Ready if PCTL is in the Clear state, regardless 
of the state of PFLG. The following program shows how to implement Ready interrupt trans- 
fers. 
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1 
110 
120 
130 

lao 

150 
IGO 
170 
180 
190 

2 
210 
220 
230 

2ao 

250 

2 GO 
270 
280 
290 

3 
310 
320 
330 

3ao 

350 
3G0 
37 
380 
390 

aoo 
aio 

a 20 
430 

aao 

450 
460 
470 
480 
490 
5 
510 
520 



Gpioil ! Reset Interfacef 
Gpio GOSUB Readv-Mfer 



PRINTER IS 1 

Gpio=12 

CONTROL 

ON INTR 

! 

DIM Data_out$[25B] 
Data-out$="123ABC" 
Points r=l 

Size=LEN(Data_out*) 
! 

! Initiate the trar!sfer4 

GOSUB Ready_xfer 

i 

! Show concurrent processing. 
Loop: C o u n t e r = C o u n t e r + 1 
DISP Counter 
GOTO Loop 
! 

STOP 



The branch to this subroutine is initiated 
first by the p r o 3 r a m > but thereafter by 
Ready Interrupt e u e n t s . 



R e a d y _ X f e r : ! 
! 

IF PomterOSize THEN 

Byte_out=NUM(Data_out$CPointer;i]) 

PRINT Data_out$CPointe r ; 1 3 ; " sent" 

CONTROL Gpio >3 ;Byte_out ! Place data on lines 

Pointer=Pointer+l 

CONTROL Gpio *1 il ! 

ENABLE INTR Gpio 52 ! 

RETURN 



Set PCTL. 

Enable Ready INTR's. 



ELSE 

DISABLE 
RETURN 



INTR Gpio 



! Disable after done. 



1 

END 
! 
i 
END 



IF 



Interrupt transfers that use the EIR line are similar to Ready interrupt transfers. The main 
difference is that the interrupt-initiating event is the EIR line, rather than the PCTL line (and 
PFLG if in Full Handshake mode) indicating Interface Ready. 
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Using the Special-Purpose Lines 

Four special-purpose signal lines are available for a variety of uses. Two of these lines are 
available for output (CTLO and CTLl), and the other two are used as inputs (STIO and STIl). 

Driving the Control Output Lines 

Setting bits and 1 of GPIO CONTROL register 2 places a logic low on CTLO and CTLl, 
respectively. The definition of this CONTROL register is shown in the following diagram. 



Control Register 2 

Most Significant Bit 










Peripheral Control 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Not Used 


PSTS 

Error 
(1 = Report; 
= Ignore) 


Set CTLl 
(1 = Low; 
= Higti) 


Set CTLO 
(1 = Low; 
= High) 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



CtlO==0 ! Clear. 

Ctll==l ! Set. 

CONTF?OL 12 .25Ctll*2 + CtlO 

As indicated in the diagram, setting a bit in the register places the corresponding line Low, while 
clearing the bit places a logic High on the line. The logic polarity of these signals cannot be 
changed. The signal remains on these lines until another value is written into the CONTROL 
register, and Reset has no effect on the state of either line. 

Interrogating the Status Input Lines 

The state of both status input lines STIO and STIl are determined by reading bits and 1 of 
STATUS register 5, respectively. A logic "1" in a bit position indicates that the corresponding 
line is at logic Low, and a "0" indicates the opposite logic state. This logic polarity cannot be 
changed. The definition of GPIO STATUS register 5 is shown below. 



Status Register 5 

Most Significant Bit 










Peripheral Status 

Least Significant Bit 


Bit? 




Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 














PSTS 
Ok 


EIR 
Line Low 


STIl 
Line Low 


STI0 
Line Low 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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STATUS 12 »5;P_status 
S t i = B I T ( P _ 5 1 a t Li 5 1 ) 
Stil=BIT(P_statu5tl) 

Reading this register returns a numeric value that reflects the logic states of these lines at the 
instant the computer reads the interface lines; the state of these lines are not latched by any 
internal or external event. 



Using the PSTS Line 

The Peripheral Status line (PSTS) is generally used to indicate whether or not the peripheral 
device is functional. The current state of PSTS may be checked by reading STATUS Register 5 
(bit 3). It may also optionally be checked automatically at the beginning of an OUTPUT or 
ENTER statement; normally, it is not checked. This feature is only enabled by by setting Bit 2 of 
CONTROL register 2. 



Control Register 2 

Most Significant Bit 










Peripheral Control 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Not Used 


PSTS 

Error 
(1 = Report; 
= Ignore) 


Set CTL1 
(1 - Low; 
= High) 


Set CTL0 
(1 = Low; 
= High) 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



When Bit 2 is set and PSTS is false at the beginning of either an OUTPUT or ENTER statement, 
Error 1 72 (Peripheral error) is reported. The error must be trapped with ON ERROR, 
since it generates no INTR or TIMEOUT branch. 
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Summary of GPIO Status and Control Registers 

Status Register Card identification = 3 

Control Register Reset interface if non-zero 



Status Register 1 

Most Significant Bit 








Interrupt and DMA Status 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Interrupts 

Are 
Enabled 


An Interrupt 
Is Currently 
Requested 


Interrupt 

Level Switches 

(Hardware Priority) 


Burst- 
Mode 
DMA 


Word- 
Mode 
DMA 


DMA 

Channel 1 

Enabled 


DMA 
Channel 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 1 Set PCTL if non-zero 



Status Register2 

IWost Significant Bit 










Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 

















Handshake 

In 

Process 


Interrupts 

Are 
Enabled 


Transfer 

In 
Progress 


Value = 128 


Value = 64 


Value = 32 


Value = ie 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 2 

IVIost Significant Bit 










Peripheral Control 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Not Used 


PSTS 

Error 
(1 = Report; 
= Ignore) 


Set CTL1 
(1 = Low; 
= High) 


Set CTL0 
(1 = Low; 
= High) 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 




Value = 2 


Value = 1 



Status Register 3 Data In ( 16 bits) 

Control Register 3 Data Out (16 bits) 

Status Register 4 

Interface is Ready for a subsequent data transfer; 1 = Ready, = Busy. 



Interface Ready 
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Status Register 5 

Most Significant Bit 










Peripheral Status 

Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 














PSTS 
Ok 


EIR 
Line Low 


STI1 

Line Low 


STI0 
Line Low 


Valuer 128 


Value - 64 


Value - 32 


Value = 16 


Value = 8 


Value -= 4 


Value = 2 


Value = 1 



Interrupt Enable Register 



Most Significant Bit 



(ENABLE INTR) 

Least Significant Bit 



Bit 7 


Bit 6 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Not Used 


Enable 
llnterface 

Ready 
Interrupts 


Enable 

EIR 

Interrupts 


Value = 128 


Value - 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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Summary of GPIO READIO and WRITEIO Registers 

This section describes the GPIO Interface's READIO and WRITEIO registers. Keep in mind that 
these registers should be used only when you know the exact consequences of their use, as 
using some of the registers improperly may result in improper interface behavior. If the desired 
operation can be performed with STATUS or CONTROL, you should not use READIO or 
WRITEIO. 

GPIO READIO Registers 

Register — Interface Ready 
Register 1 — Card Identification 
Register 2 — Undefined 
Register 3 — Interrupt Status 
Register 4 — MSB of Data In 
Register 5 — LSB of Data In 
Register 6 — Undefined 
Register 7 — Peripheral Status 

READIO Flegister Interface Ready 

A 1 indicates that the interface is Ready for subsequent data transfers, and indicates Not 
Ready. 



READIO Register 1 

This register always contains 3, the identification for GPIO interfaces. 



Card Identification 



READIO Register 3 

N^ost Significant Bit 










Interrupt Statu 

Least Signiticant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Interrupts 

Are 
Enabled 


An Interrupt 
Is Currently 
Requested 


Interrupt 

Level Switches 

(Hardware Priority) 


Burst- 
Mode 
DMA 


Word- 
Mode 
DMA 


DMA 

Channel 1 

Enabled 


DMA 

Channel 

Enabled 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



READIO Register 4 

Most Significant Bit 










MSB of Data In 

Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI15 


DI14 


DI13 


DI12 


Dill 


DIO 


Dig 


DI8 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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READIO Register 5 

Most Significant Bit 










LSB of Data In 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI7 


DI6 


DI5 


DI4 


Di3 


DI2 


DM 


DI0 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value -= 4 


1 

Value == 2 


Value = 1 



READIO Register 7 

Ivlost Significant Bit 










Peripheral Statu 

Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 














PSTS 
Ok 


EIR 
Line Low 


STI1 
Line Low 


STI0 
Line Low 


Value = 128 


Value = 64 


Value = 32 


Valuer 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



GPIO WRITEIO 

WRITEIO Register - 
WRITEIO Register 1 - 
WRITEIO Register 2 - 
WRITEIO Register 3 - 
WRITEIO Register 4 - 
WRITEIO Register 5 - 
WRITEIO Register 6 - 
WRITEIO Register 7 - 



Registers 

- Set PCTL 

- Reset Interface 

- Interrupt Mask 

- Interrupt and DMA Enable 

- MSB of Data Out 

- LSB of Data Out 

- Undefined 

- Set Control Output Lines 



WRITEIO Register Set PCTL 

Writing any non-zero numeric value to this register places PCTL in the Set state; writing zero 
causes no action. 



WRITEIO Register 1 

Writing any non-zero numeric value to this register resets the interface. 



Reset Interface 



The GPIO Interface 411 



WRITEIO Register 2 



Interrupt Mask 

Least Significant Bit 



Bit? 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


BitO 


Not Used 


Enable 

Interface 

Ready 

Interrupts 


Enable 

EIR 

Interrupts 


Valuer 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



WRITEIO Register 3 

Most Significant Bit 








Interrupt and DMA Enable 

Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Enable 
Interrupts 


Not Used 


Enable 
Burst- 
Mode 
DMA 


Enable 
Word- 
Mode 
DMA 


Enable 

DMA 

Channel 1 


Enable 

DMA 

Channel 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



WRITEIO Register 4 

Most Significant Bit 



MSB of Data Out 

Least Significant Bit 



Bit 7 



D015 



Value = 128 



Bite 



DOM 



Value = 64 



Bit S 



D013 



Value = 32 



Bit 4 



D012 



Value = 16 



Bits 



D011 



Value = 8 



Bit 2 



DO10 



Value = 4 



Bit 1 



D09 



Value = 2 



BitO 



DOS 



Value = 1 



WRITEIO Register 5 



LSB of Data Out 

Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


BitO 


D07 


D06 


DOS 


D04 


D03 


D02 


D01 


DO0 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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WRITEIO Register 7 



Set Control Output Lines 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Not Used 


Set CTL1 
(1 = Low; 
= High) 


Set CTL0 
(1 = Low; 
= High) 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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This chapter should be used in conjunction with the HP 98623 BCD Interface Installation Note. 
The best way to use these two documents is to first read the section of this chapter called "Brief 
Description of Operation" to see how the interface works with the BASIC language. Within this 
section is information about the interface's modes of operation that will help you to understand 
how you might use the interface for your application. Second, read "Configuring the Interface" 
while referring to the Installation Note as necessary to configure and connect the interface 
according to your application's needs. The reason for this order is that you will probably be able 
to configure and use the interface once you know a little about how it works. 



The main section of the chapter presents several techniques for using the interface to move data 
between the computer and peripheral devices using BASIC programs. 
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Brief Description of Operation 

The HP 98623 Interface consists of data registers and handshake circuitry required to transfer 
data to and from the computer using either BCD or binary data formats. The interface cable 
contains the following sixty-four conductors: 

• forty data, two sign, and one overload signal lines used to enter data from the peripheral 

• eight lines used to output data to the peripheral 

• two sets of handshake lines (two wires per set) 

• one reset line to the peripheral device 

• one five-volt logic line 

• five logic (signal) grounds and two safety (shield) grounds 

Data Representations and Formats 

The BCD interface can be used to transfer data using one of two data representations; BCD 
(binary-coded decimal) and binary representations. BCD is the default data representation; the 
binary representation may be selected by software (as described in the configuration section). 

The BCD Data Representation 

When the BCD representation is in use, data lines are handled in groups of four lines each, with 
each group representing one BCD digit. The sixteen possible combinations of logic states and 
corresponding characters which each four-line group may represent are as 'ollows; 



Data Line 


Character 


Data Line 


Character 


Logic Sense 


Represented 


Logic Sense 


Represented 


(MSB) (LSB) 




(MSB) (LSB) 










10 


8 


1 


1 


10 1 


9 


10 


2 


10 10 


line-feed 


11 


3 


10 11 


4 


10 


4 


110 




10 1 


5 


110 1 


_ 


Olio 


6 


1110 


E 


111 


7 


1111 





When the BCD representation is in use, the data lines are read sequentially in groups of four 
lines each. For each four-bit BCD character read, a corresponding ASCII character (listed 
above) is generated. Operating system "drivers" control both the sequence of reading the 
BCD-character groups and the generation of the appropriate ASCII character which each group 
represents. The sequence used by the drivers and the resultant numeric value entered depends 
on which BCD format is currently in use; Standard or Optional format. 

Standard Format 

The Standard BCD format is used to connect one peripheral to the computer. The data lines 
are arranged as follows to form two numbers; one mantissa sign bit, eight BCD mantissa 
characters, one exponent sign bit, and one BCD exponent character form the first number; one 
overload-indicator bit and one BCD character are combined to form the second number. 
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The following diagram shows how the signal lines are organized in Standard format (i.e., the order 
in which the lines are read with ENTER statements). The notation used with these diagrams is as 
follows: SGNl, SGN2, and OVLD are individual signal lines, while DIl through DUO are groups of 
four lines each. The signal lines of group DIx (in which x denotes one of the BCD characters 1 
through 10) consist of DIx-8, DIx-4, DIx-2, and DIx-1; the 8, 4, 2, and 1 suffixes are used to denote 
the binary-weighted significance of each line. 



Standard Format (Read One BCD Device) 



Signal Name 


SGNl 


DIl 


D12 


DI3 


DM 


DI5 


DI6 


DI7 


DI8 




SGN2 


DI9 




OVLD 


DUO 




[nlo. 


Mart. 
Sign 


MSD 














LSD 


Exp. 
Char. 


Exp 
Sign 


Exp. 
Digit 


Comma 


= OVLD 
8= OVLD 


Fn. 
Digit 


Line-Feed 














BCD Char. 
(Pos. True) 


+ 1011 
-1101 


0000 
thru 

nil 














0000 
thru 

nil 


1110 


+ 1011 
-1101 


0000 
thru 

nil 


1100 


0000 
1000 


0000 
thru 

nil 


1010 














ASCII Char. 


+ - 


X 


X 


X 


X 


X 


X 


X 


X 


E 


+ - 


X 


, 


OorS 


X 


LF 



Let's take a closer look at how data are entered into the computer with a BASIC-language 
ENTER statement while using the Standard format. (Standard format is selected when the 
Peripheral Status Switch marked "OF" is in the "ON" position; further details will be given in 
the subsequent configuration section. ) Suppose the following logic signals are present on the 
lines from the peripheral device: 



Signal 
Name 




CO ■* cvl -Y 
QQQQ 


op ■^ CJ Y 
<N C<I <N Cvl 

QQQQ 


opTttNv 
CO CO CO CO 
QQQQ 


■t ■* ■* TJ- 

QQQQ 


°P T "^ T 
in lO Lo in 

QQQQ 


CO ■* C^ T- 
<D CD (D CO 
QQQQ 


CO -^ CNJ Y 

r^ r^ ri li 
QQQQ 


op Tf CVI Y 

CO 00 ob 00 
QQQQ 


CM 
Z 
C3 
Cfl 


op ■* CM T^ 

O^ Oi Ci Oi 
QQQQ 


Q 

_] 

> 

o 


DI10-8 
DIl 0-4 
DIl 0-2 
DIl 0-1 


Logic 
Level 


1 


1 


10 


11 


10 


10 1 


110 


111 


10 





10 1 





10 


BCD 
Character 


- 


1 


2 


3 


4 


5 


6 


7 


8 


+ 


9 





2 



Number = - 1 .2345678E + 1 6 
Function = 2 



Let's further assume the following: the Peripheral Status Switch settings are DATA = ON, 
SGNl = ON, SGN2 = 0N, OVLD = ON; and the following ENTER statement has been ex- 
ecuted (with the BCD Interface as the source): 

ENTER B c d i N Udi b e r > F un c t i o n 

The E NTER statement is executed as follows. The computer first initiates a handshake with the 
CTLA signal (handshake operation is also described in the configuration section). The peripher- 
al responds to the request by placing data on the lines and then completing the handshake. The 
states of all data lines are now stored in registers on the interface (i.e, the data signals are 
"latched"). 



The Standard-format driver reads the state of the SGNl line and generates an ASCII "-h" 
character. The "number builder" routine of the free-field ENTER statement (described in 
Chapter 5) is used to construct the number as characters are entered for the variable Numb e r. 
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The BCD digits DIl through DI8 are then read and used to form the mantissa. The "E" 
character is generated automatically by the driver, after which it reads the SGN2 line and 
generates a " - " character. BCD digit DI9 is read; the driver generates a "3" for the exponent 
character. A comma is automatically generated by the driver, terminating entry into Nuiiibe r. 
The number builder then constructs the internal representation of - 1.2345678E + 16, which is 
placed in Nuwbe r. 

Since one additional numeric variable has been specified in the ENTER statement, the compu- 
ter continues to enter characters from the interface. The OVLD signal line is read, and a "0" is 
generated and entered. BCD digit DUO is read, and the resultant ASCII "2" is entered by the 
number builder. The driver automatically generates the line-feed character, which terminates 
both entry of characters into the Function variable and the ENTER statement. The variable 
Funct i on is assigned a value of 2, and the ENTER has finished execution. Further examples 
of sending and receiving data through the BCD Interface are given in the main section of this 
chapter. 

Optional Format 

With the Optional format, two peripherals may be connected to the interface. One four-digit 
and one five-digit mantissa are generated with this format. The signal lines are organized as 
follows with Optional format: 

Optional Format (Read Two BCD Devices) 





First Device (FD) 




Second Device (SD) 










Signal Name 


SGNI 


DI4 


DI2 


D16 


D18 




SGNZ 


DIU) 


DIl 


D15 


DI3 


DI7 




OVID 


DI') 




Info. 


Mant. Suiii 


MSD 




* 


LSD 


Comma 


Mant Si9:i 


MSD 






^ 


LSD 


Exp. Char. 


FL 


SD 


Lint' FtiL'd 










' 


BCD Char. 
(Pos. True) 


^ 101 1 
- 11(11 


0000 
thru 

nil 






0001) 
thru 

nil 


1111(1 


+ 1011 
1101 


0000 
thru 

nil 








0000 
thru 

nil 


1110 


OOOO 
thru 
lOOO 


0000 
thru 
100(1 


1010 












ASCII Char 


+ - 


X 


X 


X 


X 




+ - 


X 


X 


X 


X 


X 


E 


oi ti 


or 8 


LF 



Let's take a closer look at how data are entered i nto the computer by a BASIC-language 
ENTER statement while using the Optional format ("OF" = OFF). Suppose the following logic 
signals are present on the lines from the peripheral device: 



Signal 
Name 


z 

CO 


OO ^ OJ T^ 

4 ■!)■ -i- 4 

Q QQQ 


CO ^ C\J r- 
c(l C^ CM C\J 


00 ■* PJ T^ 
(D (O (i) CD 

QQQQ 


CO -a- CVI T^ 


z 


CO -^ CM T^ 

ds <i o CD 


00 -^ OJ ^ 


CO ■* OJ r- 

iT) LO to Ln 
QQQQ 


CO Tl- OJ T- 
CO CO CO CO 

QQQQ 


00 -"t oa T^ 
t~^ h^ t^ 1-^ 
QQQQ 


Q 
_i 
> 

o 


00 -a- oj ^ 

G> Oy G^ O) 

QQQQ 


Q QQ Q CO 


Q 5 5 5 


DQQQ 


Logic 
Level 


1 


10 


10 


110 


10 








1 


10 1 


11 


111 


1 


1 


BCD 
Character 


- 


4 


2 


6 


8 


+ 





1 


5 


3 


7 


8 


1 



Number_1 
Number_2 



4268 

1 .537E -1 84 
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Let's further assume that the Peripheral Status Switches are set as follows: DATA = ON, 
SGNl=ON, SGN2 = 0N, OVLD^ON; and that the following ENTER statement has been 
executed (with the BCD Interface as the source): 

ENTER Bed ;Nuii)ber_l fNufiiber_2» 



The computer initiates a handshake with both peripherals by using the CTLA and CTLB signals 
(handshake operation is described in the configuration section). Both peripherals must respond 
to the request by placing data on the lines and then completing the handshake. The states of all 
data lines from the first device are now stored in registers on the interface (i.e, the data signals 
are "latched"). 

As with Standard format, the Optional-format driver reads the states of the signal lines from the 
peripheral and generates the appropriate ASCII characters. The computer uses the "number 
builder" routine of the free-field ENTER statement (described in Chapter 5) to enter the ASCII 
characters from the interface and to generate the internal representation of the number(s) 
represented by the BCD characters. 

In this example, the logic state of SGNl (1, or True) is read by the driver, which generates a 
" - " character (see table). The BCD digits DI4, DI2, DI6, and D18 are read, and corresponding 
characters are generated. The comma (generated by the driver) terminates entry into the first 
numeric variable, called Numfae r_l. In this case, the value assigned to Numbe r_l is -4268. 

Since another number has been specified in the ENTER statement, the computer continues to 
enter characters through the interface until the line-feed is entered. A value of 1.537E-I-84 is 
assigned to the variable Nuwber_2. The line-feed character (also generated by the driver) 
terminates both entry of characters into Numbe r_2 and the ENTER statement. Further exam- 
ples of entering data through this interface are given in in the main section of this chapter. 

The Binary Data Representation 

A binary data representation is available on the HP 98623 BCD Interface. With this representa- 
tion, the forty data lines (groups Dll through DUO) are treated as five individual data bytes 
which can be entered using ENTER or STATUS statement(s). 

The Binary Mode 

Unlike the BCD representation, the Binary Mode has no Standard and Optional format; thus, 
the setting of the Option Format switch has no effect while in the Binary Mode. 

To select the Binary Mode, write a non-zero numeric value into BCD Control register 3; the 
following statement shows a typical method. 

CONTROL 11 ,3;i 
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To see how the ENTER statement enters data through the BCD Interface while in Binary Mode, 
let's suppose the logic signals on the data lines are as follows. 



Signal 
Name 








0O-*C\Ji-0O'^C\l'- 


CO t C\] T- 

°?r'^-7 666,6 

OlOCDO) 1— T— -I— 1— 


QQQQQQQQ 


DQQDQQQQ 


QQQQ QQQQ 


QQQQQQQQ 


QQQQQQQQ 


Logic 
Level 


1 10 1 


1 10 10 


110 11 


10 10 1 


110 10 1 


Decimal 
Value 


49 


50 


51 


69 


53 


ASCII 
Character 


1 


2 


3 


E 


5 



Let's make the same assumptions that have been made in the previous examples: the logic 
sense of the data lines is positive-true (the "DATA" switch is set to "ON") Assume that the 
following ENTER statement has been executed. 

ENTER Bed USING " B" i By t e 1 »By t e2 »By t e3 t5y t e4 f By t e5 



The Control signal line (CTLA) is placed in the Set state by the computer to signal to the 
periphera l that a data transfer is to take place. The peripheral responds on the Data Flag line 
(DFLGA), completing the handshake and clocking ("latching") the data on the lines into 
interface registers. 

The Binary-Mode driver begins reading the line states as bytes in the order Dll through DUO; 
the first byte contains DM as the most significant bits and DI2 as the least significant bits. The 
second byte contains DI3 and DI4, and so forth. In this case, the values 49, 50, 51, 69, and 53 
are given to the variables B y t e 1 through B y t e 5, respectively. 

In this example, the "B" image is used to direct the computer to enter the data on the input 
signal lines as bytes. A line-feed character is generated by the driver to terminate the ENTER 
statement. 

As another example, suppose that the data on the input lines and the switch settings are as in 
the preceding example. Let's look at how the computer would enter the data with the following 
statement. 

ENTER Bed SNumbe r 



As in the preceding example, the ENTER statement latches the data into the interface registers 
with the same handshake. The Binary-Mode driver begins reading the line states as bytes in the 
order DU through DUO; the first byte contains Dll as the most significant bits and DI2 as the 
least significant bits. The second byte contains DI3 and DI4, and so forth In this case, the 
characters "123E5" are entered, followed by a line-feed generated by the driver. In this case, 
the variable Numb e r receives a value of 1.23E -I- 7. 
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Alternate Methods of Entering Data 

As with other interfaces, the data signal lines' logic states can be read with STATUS statements. 
However, no handshake is performed with this method of entering data. 

With the E5CD Interface, STATUS registers 5 through 9 contain digits DIl through DUO, and 
STATUS register 4 contains SGNl, SGN2, and OVLD. Examples are given in the main section 
of this chapter. 

Outputting Data 

Data may be output through the BCD Interface by using the OUTPUT statement. Data are sent 
through the eight output lines in byte-serial fashion. The eight lines are called DO-7 through 
DO-0, in which DO-7 is the most significant bit. Numeric data are sent with the most significant 
digits first; string data are sent with the lowest-subscripted string characters sent first. Repre- 
sentation depends on whether FORMAT ON or FORMAT OFF is in effect. 

Let's look at how data are output through the BCD Interface with the following OUTPUT 
statement. 

OUTPUT U ;"A2C" 

With OUTPUT, each byte is transferred under control of a handshake which is identical to a 
corresponding ENTER handshake. The Binary-Mode driver does not send four-bit BCD digits, 
it sends entire bytes of data; so the driver does not perform any ASCII-to-BCD translation. The 
items specified in the OUTPUT list are evaluated and sent to the BCD Interface byte-serially. 
The following diagram shows the logic signals that appear on the Data Output signal lines: 





Decimal 


















ASCII/Char. 


Value 


DO-7 


DO-6 


DO-5 


DO-4 


DO-3 


DO-2 


DO-1 


00-0 


A 


65 





1 

















1 


2 


50 








1 


1 








1 





C 


67 





1 














1 


1 


Cr 


13 














1 


1 





1 


■-F 


10 














1 





1 






Notice that the free-field convention is used, since the free-field form of the OUTPUT statement 
was used. The CR-LF (default) EOL sequence is sent after all items have been output. The 
same data may be sent with the following statement. 

OUTPUT 11 USING "« .B" ;B5 »50 »G7 »13 .10 
Other examples are given in the main section of the chapter. 
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Configuring the Interface 

This section describes the range of or recommended interface's switch settings for use with 
BASIC language. The switch locations are described in the HP 98623 BCD Interface Installa- 
tion Note. 

Determining Interface Configuration 

If the interface is already installed in a computer which currently has the BASIC-language 
system resident, you can determine the configuration by running the following program. If the 
interface is not yet installed, you may want to check the switch settings as you read this section 
to see that they are set for use with your particular application. 

100 PRINTER IS 1 

110 PRINT CHR$(12) ' Clear screen. 

120 ! 

130 DISP "Enter select code of BCD Interface." 

140 ENTER 2;isc 

150 DISP 

leo ! 

170 ON ERROR GOTO SKiP^status ! SKip if ba.d iso. 

180 STATUS Iscild 

190 Skip_statijs: OFF ERROR 

2 ! 

210 PRINT "The Interface at select code "ilsci 

220 IF Id =4 THEN 

230 PRINT "is a BCD Interface." 

240 ELBE 

250 PRINT "is NOT a BCD Interface." 

260 PRINT "Prosraiii terminated." 

270 STOP 

280 END IF 

290 PRINT 

3 I 

310 CONTROL Iscil ! Reset interface. 

320 I 

330 STATUS I s c . 1 i I n t r_5 t at us 

340 MasK=2'5+24 ! MasK out all but bits 5 and 4. 

350 Bit5_set=BINAND(Intr_5tatus.MasK) 

3B0 Hd_priDr= (Bits-set MOD 16)+3 I Shift Rt. and add 3. 

370 PRINT "Hardware priority (Interrupt Leuel) is " i Hd_p r i o r i " . " 

380 PRINT 

390 ! 

400 STATUS Isc i3 ;Binarv_(iiode 

410 IF Binary_mode THEN 

420 PRINT "Binary mode selected." 

430 ELSE 

440 STATUS I s c .4 iSwi t c he s 

450 IF BIT(SiAii tches .7) = 1 THEN 

i\EO PRINT "BCD mode. Optional format selected (2 devices)." 

470 ELSE 

aeo PRINT "BCD mode. Standard format selected (1 deuice)." 

490 END IF 

500 END IF 

510 PRINT 

520 ! 

530 PRINT "Losic sense of signals:" 

540 IF BIT(Switches tG) =1 THEN 

550 PRINT " Input data: Loiai=1j Hi3h = 0." 

5G0 ELSE 

570 PRINT " Input data: Low=0. Hi3h=l." 

580 END IF 

590 ! 

600 IF BIT (Switches .5) = 1 THEN 

GIO PRINT " SGNl: Hi3h=""+"". Low=""-""." 

G20 ELSE 
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G30 


PRINT " 


SGNl : 


Hi3h = ""-"" , Low 


G^O 


END IF 






650 


! 






6S0 


IF BIKSwitch 


65,^)=! 


THEN 


G70 


PRINT " 


SGNZ: 


Hi Sh=" " + " " , Lou 


BBO 


ELSE 






B90 


PRINT " 


SGNZ: 


Hi*h=""-"" , Low 


700 


END IF 






710 


! 






720 


IF BIT (Switch 


es .3) = 1 


THEN 


730 


PRINT " 


OVLD: 


Hi9h=0. Ldw=8." 


7ao 


ELSE 






750 


PRINT " 


DULD: 


H i S h = 8 1 L w = . " 


7B0 


END IF 






770 


PRINT 






780 


1 






790 


END 







I ^ M II ! 



Setting the Interface Select Code 

The interface's select code setting determines the value of the interface select code parameter in 
which is used in ENTER and OUTPUT statements to specify the interface through which data is 
to be sent. The allowable range is 8 through 31, since internal interfaces already use select 
codes 1 through 7. Keep in mind that no two interfaces should be set to the same select 
code. 

The default select code is 11. If a different select code is desired, set the switches as described in 
the installation note. 

Setting the Hardware Priority (Interrupt Level) 

The hardware priority assigned to an interface determines the order in which the interrupts from 
the interface are logged by the system. The software priority of interrupts determines the order 
of interrupt service, which is independent of this hardware priority. 

A default setting of 3 is generally used. See the installation note for switch location and settings. 

Setting the Peripheral Status Switches 

The peripheral status switches are used to select the format of BCD data and the logic sense of 
data input lines. The OF switch selects between the Optional BCD format and the Standard 
BCD formcJt. Set the switch to ON (default) if Standard is desired, or to OFF if Optional format 
is desired. The setting of this switch is irrelevant if the interface is only to be used in the Binary 
mode. 

The DATA switch determines the logic sense of all 40 data input lines. If set to ON, positive-true 
logic is used (logic high is a 1). If set to OFF, negative-true logic is used; (logic low is a 1). 

The SGNl and SGN2 switches determine the logic sense of the respective sign-bit signal lines. 
If set to ON, a logic high signifies a " - " and logic low signifies a " -I- ". If set to OFF, a logic high 
signifies a " -I- " and logic low signifies a " - " . 

The OVLD switch determines the logic sense of the OVLD signal line. If set to ON, a logic high 
is entered as an "8" and a low is entered as a "0". If set to OFF, a logic high is entered as a "0" 
and low is an "8". 
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Setting the Handshake Configuration 

The handshake used by the BCD Interface is a two-wire handshake that synchronizes the 
exchange of data in one of two general manners: Type 1 timing or Type 2 timing. Type 1 and 
Type 2 timing differ in when the peripheral's data are clocked (latched) into the interface's data 
registers. 



The logic sense of both th e Contr ol lin es from the computer (CTLA and CTLB) and Data Flag 
lines from the peripheral (DFLGA and DFLGB) are switch-selectable. 

Type 1 Timing 

With Ty pe 1 hands hake timing, the Busy-to -Ready tr ansitio n of the peripheral's data flag line 
(DFLGA or DFLGB) Clears the Control line (CTLA or CTLB) from the computer and clocks the 
data into the interface's Data In registers. The following timing diagram shows an example of 
how this sequence of events takes place. Note that the CTLA and DFLGA switches are set to 
OFF (Low-true). 



CTLR 



DFLGR 



DflTR Lines 



Clear — ^ 

Set 

Busy 

Ready — ^ 

0-4- 

i 

1 -^ 



-1} ih 



-ih 



■ih 



-ih 



Hh 




DflTfl 
VALID 



^0 ^1 ^2 ^3 "'^4 

Type 1 Handshake Timing Diagram 



At time tO, CTLA is Clear and DFLGA is Ready, indicating that a transfer may be initi ated. At 
time tl, the computer initiates the handshake. At t2, the peripheral responds by placing DFLGA 
Busy. The peripheral then places the data on the data lines. When data have settled, the 
peripheral completes the handshake by placing DFLGA Ready, which also Clears CTLA and 
clocks the data into the interface registers (at time t4). Another handshake cycle may then be 
initiated by the computer. 



Note 

If only one periph eral is c onnected to the interface, connect the 
CTLB line to the DFLGB line and set both CTLB and DBLGB 
switches to the OFF positions. If this is not done, the handshake 
cannot be completed. 
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Type 2 Timing 

With Typ e 2 handsh ake timing, the Ready-to-Busy transition of the peripheral's data flag line 
(DFLGA or DFLGB) Clears the Control line from the computer; however, the Busy-to-Ready 
transition still clocks the data into the interface's Data In registers. The following timing diagram 
shows an example of how this sequence of events takes place. Note that the CTLA and DFLGA 
switches are set to OFF (Low-true). 



CTLfl 



DFLGn 



DfiTH Lines 



Clerr — ^ 



Set 

Busy 

Ready 

i 

1 



-ih 



-ih 



■^^ 



^^ 



'0 '1 



■ih 



-ih 



:>■ 



DfiTH 
VALID 



T2T3 



Type 2 Handshake Timing Diagram 



At time tO, CTLA is Clear and DFLGA is Ready, indicating that a transfer may be initi ated. At 
time tl, the computer ini tiates t he handshake. At t2, the peripheral responds by placing DFLGA 
Busy, which also Clears CTLA. When ready, the peripheral places DFLGA Ready (at time t4), 
which also clocks the data into the interface registers. Another handshake cycle may then be 
initiated by the computer. 



Note 
If only one periph eral is c onnected to the interface, connect the 
CTLB line to the DFLGB line and set both CTLB and DFLGB 
switches to the OFF positions. If this is not done, the handshake 
cannot be completed. 

Configuring the Cable 

The installcjtion note describes how to connect the cable wires. Any unused lines should be 
connected as follows: connect the line to the " + 5 Ref" signal line if the line is to be read as 
high, or to logic ground if the line is to be read as low. With lines such as SGNl, SGN2, and 
OVLD the line may be tied either to ground or to + 5V, because the logic-sense switch allows 
either sense to be selected independent of other signals. 



Note 

Be sure to follow the recommendations in the installation note ex- 
actly to ensure signal integrity and operator safety. 
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Interface Reset 

The interface should always be reset to ensure that it will be in a known state before use. All 
interfaces are automat ically reset by the computer at certain times: when the computer is 
powered on, when the (RESET) key is pressed, and at other times described in the Reset Table (in 
the Useful Tables). The interface may also be reset by BASIC programs, as in the following 
examples. 

Bcd=ll 
CONTROL Bcdil 



Reset- yalije=l 

CONTROL Bed »0 ;Reset_i.ialue 



RESET Bed 
The following action is take when the BCD Interface is reset: 



• The peripheral reset signal line (PRESET) is pulsed low for at least 15 microseconds. 

• The CTLA and CTLB handshake lines are Cleared. 

• The Data Out register is cleared (set to all O's). 

• The Interrupt Enable bit is cleared, disabling subsequent interrupts until re-enabled by the 
program, and the Interrupt Request bit is set. 

The state of the BCD/Binary Mode register (STATUS and CONTROL Register 3) is unchanged 
by the Interface Reset. 
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Entering Data Through the BCD Interface 

This section describes BASIC programming techniques useful for entering data through the 
BCD Interface. Several examples of entering data were given in the first section to show how 
the interface works in BCD Mode with Standard and Optional formats and Binary Mode. This 
section gives additional general techniques for entering data from peripheral devices. If you 
need further explanation of how the ENTER statement works, refer to Chapter 5; Chapter 6 
discusses the STATUS statement. 

The diagrams and corresponding BASIC-language statements in this section show how data on 
the interface signal lines get read by the ENTER statement and corresponding values assigned 
to BASIC-language variable(s). The notation used in the examples is that the name of the 
interface signal line (or group of lines) is shown above the decimal value and ASCII character 
that the driver produced by reading the line(s). The logic sense of the lines is not shown here; 
see the preceding configuration section for a description of selecting the logic sense of the 
interface signals. 

As an example, the following drawing shows that an ASCII " + " was generated by the driver 
when it read the SGNl signal line; similarly, the four signals of the group DI5 produced a period 
character. The driver produces the "E" (exponent), comma, and line-feed characters automati- 
cally. 



SGN1 DI1 DI2 DI3 



DI4 



DI5 DI6 DI7 DI8 



SGN2 DI9 



OVLD DUO 



+ 


1 


2 


3 


4 




6 


7 


8 


E 


- 


6 


, 





4 


LF 



The following statements show how the preceding data might be entered and the resultant 
values assigned to program variables. 



B c d == 1 1 

E N T E: R B c d 5 N 1.1 (ii b e r > F i.m c t i n 
PRINT "NuMber= " !Number 

PRINT "Furictiori= "JFuncti^n 



The following display is the result of executing the preceding statements. 



Nuiiibe r = 
Function: 



1 ,234B78E-3 
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Entering Data from One Peripheral 

There are several methods of entering data through the BCD Interface when only one peripher- 
al device is connected. The Standard BCD format can be used with many devices; the Binary 
mode must be used with others, and some require that you write your own "drivers." 

Entering with BCD-Mode Standard Format ■ 

Using the Standard format of BCD Mode usually provides the most convenient means of 
entering data from one device. This format allows up to 8 BCD digits for mantissa and one BCD 
digit for exponent. The state of an overload-indicator signal and one optional BCD digit can 
also be entered, if desired. 



SGN1 DM DI2 DI3 DI4 DI5 DI6 DI7 DI8 



SGN2 DI9 



OVLD DUO 



LF 



100 ENTER 1 1 iNumbe r jFunc t ion 

110 PRINT "Number= "iNuinber 

120 IF Function:::- = 80 THEN 

130 PRINT "Oyerload of function " iFunc t i on-80 

lao ELSE 

150 PRINT "Function^ "iFunction 

IGO END IF 

The following results would be printed by the preceding program segment: 

Nutiibe r= 3a5B 

Overload of function 4 

The ENTER statement calls the Standard-format driver, which reads the BCD characters on the 
interface lines in the order shown and generates the approptiate ASCII characters. Characters 
are entered until the "," is read, which terminates entry into the variable Numb e r. The charac- 
ters after the comma are used to build the value of Function. The ENTER statement is 
propedy terminated when the line-feed (an ENTER-statement terminator) is encountered. 

Notice that an "8" is generated by the driver when the OVLD line is true. The BASIC program 
must "separate" this from the "function" digit (DUO). The method shown in the example is 
only one of many methods available. 

If a second variable would not have been included in the preceding ENTER statement, ENTER 
would have continued asking the driver for characters until it encountered the line-feed, which 
terminates the statement. 



To contrast the preceding example, suppose that the following statement has been executed: 
ENTER 11 USING "«»K";Number 
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In this case, the « specifier directs the ENTER statement to suppress its default requirement of 
looking for a line-feed character (or oth^ statement-termination condition) to terminate the 
ENTER. Thus, the comma terminates both entry of data into N urn be r and the ENTER state- 
ment. Consequently, a subsequent ENTER statement would begin entering characters begin- 
ning with the "8" character (OVLD), which may not be the desired action. 

In such a case, several remedies are possible. The simplest is probably to go ahead and include 
a second variable so that the driver is left pointing to the first character after the ENTER is 
completed. The second variable is thus used for a "dummy" read operation. Another remedy is 
to write a non-zero value to BCD CONTROL register 1, which "resets" the driver pointer to the 
first character of the format (SGNl). Executing the following statement performs the driver 
reset. 

CONTROL 11 .1 ;i 

This type of "problem" may also occur when the BCD device sends a line-feed as one of the 
BCD characters. 

SGN1 DI1 DI2 DI3 DI4 DI5 DI6 DI7 DI8 SGN2 DI9 OVLD DUO 



- 


1 


2 


LF 


4 


5 


6 


7 


LF 


E 


+ 





1 








LF 



In such Ccise, two numbers are sent separated by line-feeds. The following statements would 
read these two numeric values and then reset the driver pointer to the first character (the SGNl 
character). 

ENTER 11 !Nuwber_l fNutnber_2 
CONTROL 11 .1 ;i 

If the CONTROL statement had not been executed, the driver would have been left pointing to 
the "E" character. 

As another example, suppose the exponent is to be ignored but the overload and function digits 
are to be read. The following statement would be appropriate in such a situation. 

ENTER 11 iNumbe r_l >Numbe r_2 >DufiUiiy »Funct i on 

The variable Dummy is so named to show that it is included in the ENTER statement only to 
ensure that the overload and function digits are read and assigned to a variable (i.e., it is not 
used for any other purposes). Of course, the value could be used if desired. 

If your application requires reading only certain characters or groups of characters, you may 
want to read Chapter 5 to see more examples of using images with ENTER statements. 
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Entering with Binary Mode 

If your application represents data with eight-bit ASCII characters or has a data format that is 
not compatible with the Standard BCD format, the Binary Mode can be used. With the Binary 
Mode, data are entered in groups of eight bits each, rather than in groups of four-bit BCD digits. 
Five bytes are latched with each handshake; the driver reads the bytes sequentially until the 
fifth byte is read, after which it sends a line-feed character to terminate the ENTER. Another 
handshake operation is required if more data are to be entered. 

As an example, let's assume that the following logic signals are present on the interface lines. 
Only 16 signals are shown here because that is all that we will be using for this example. 



Signal 
Name 


°P t ^ V 
55 55 


CD ^ cvj Y 

cy CN CN C>J 

QQQ Q 


CO ^ eg T- 
co CO CO CO 
Q DQ Q 


ap rt OJ T^ 
Tl" 4 ^ 4 

Q QQ D 


Logic 
Level 


10 


1 


11 


1 


Decimal 
Value 


65 


49 


ASCII 
Character 


A 


1 



Assume also that the I/O path name "(g)Bcd" is assigned to the select code of a BCD Interface. 
The following ENTER statement enters these two bytes of data as numbers in the range 
through 255. 

ENTER SBcd USING " B " JD i 1 _d i 2 tD i 3_d i 4 

The "B" specifier directs the computer to enter one byte of data from the interface and place it 
into the corresponding numeric variable, which happens two times in this case. The variables 
Dil_di2 and Di3_di4 receive values of 65 and 49, respectively. The ENTER statement 
continues to request characters from the Binary-Mode driver until a line-feed (generated by the 
driver) is returned, which terminates the ENTER statement. Even though only two bytes were 
used to fill variables in this example, all five bytes of data were read from the interface. 

The following statement could be used to enter the two bytes as one 16-bit word. 
ENTER @Bcd USING "W'SWordl 



The variable "Wordl" receives a value of 16 689 ( =256*65 4-49). 
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As another example, suppose that the data on the lines are to be interpreted as ASCII charac- 
ters. The following diagrams show the ASCII representations of data read from the interface; 
entering ten bytes of data in this mode requires two handhake cycles. 



DI1&DI2 


DI3&DI4 


DI5&DI6 


DI7&DI8 


Dig&Dho 




1 


2 


3 


4 


5 


LF 


DI1&DI2 


DI3&DI4 


DI5&DI6 


DI7&DI8 


DI9&DI10 


6 


7 


8 


E 


3 


LF 



The following ENTER statement enters characters until an item terminator is found and then 
calls the "number builder" routine to construct the number; this sequence is performed for 
each numeric variable in the statement. 

ENTER Bed 5Nu(Tibe r_l jNumbe r_2 

In this case, Number_l is assigned a value of 12345, and Nu(iiber_2 is assigned 6.78E + 5. 
With a Binary-Mode ENTER, the driver does not read SGNl, SGN2, or OVLD, and does not 
insert any E's, or commas; only a line-feed is generated as a sixth character to terminate the 
ENTER statement. 



If your application has a data format that is not compatible with the Standard BCD format, the 
Binary Mode can be used in conjunction with a routine of your own design that is tailored for 
your application's requirements. Let's look at an example of how this might be accomplished. 

Suppose that your peripheral requires five digits of mantissa but must have three exponent 
digits and two function digits. A program will be used to read the data using the desired format. 
If the peripheral's handshake method is compatible with one of the handshake types available 
on the BCD Interface, the Binary mode may be used to enter the data; if not, see the example 
of implementing a handshake in the next section. 

For this example, suppose the following conditions exist: the mantissa is entered from DIl 
through DI5, the exponent is entered from DI6 through D18, and function is entered from DI9 
and DUO. The mantissa and exponent signs and the overload indicator are still available as 
individual signal lines, but they must be read with the STATUS statement. 
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The subroutine shown in the following program reads the data on the lines with ENTER and 
STATUS statements and then formats the data as required for the application. The formatted 
information is then entered from a string variable into the desired numeric variables. 



1 
110 
120 
130 

i<ao 

150 
ISO 
170 
180 
190 
2 
210 
220 
230 

2ao 

250 
2B0 
270 
2 80 

2 90 

3 00 
3 10 
320 
330 
3^0 
350 
3G0 
370 
380 
390 

aoo 

410 
a20 
430 

a^o 

450 
4G0 
470 
480 
490 
500 
510 
520 
530 
540 
550 

5 BO 
570 
580 
590 
GOO 
GIO 
G20 

6 30 
6 40 
G50 
6 60 

6 70 
680 
690 

7 
710 
720 
730 
740 
750 



This proSraiii eKecutes a subroutine which enters data from the 
BCD Interface usinS Binary mode and formats it as follows: 

SGNl DIl DI2 DI3 DI4 DI5 E SGN2 DIG DI7 DIB , 
OULD Dig DUO LF 

Define orderins of BCD characters. 
Bcd.cha r5$="012345G789+ .-E. " 

B c d = 1 1 

CONTROL Bcd,3;i > Set Binary mode. 

j 

G 9 U B N e w _ f r (II a t ! Execute subroutine. 

ENTER Fo rmat$ iNurnbe r iFun c t i on ! Use results for ENTER. 

PRINT " Numb e r= "! Numb e r 

PRINT " F u n c 1 1 n = " i F u n c 1 1 o n 
I 

BTDP 



Nei.i_f rmat : ! ♦♦♦♦♦♦* BeSinninS of Subroutine. ******* 
I 

! Perform a Binary-mode ENTER. 

ENTER Bed USING "5A";Bytes$ ! 5 bytes read, 



! Use STATUS to read SGNl, SGN! 
STATUS Bed ,4 ;S3ns_and_0Mld 



OULD, 



I Generate two ASCII characters from each byte, 
FOR Byte=l TO 5 
! 

! Get numeric u a 1 u e of s i n 3 1 e byte from B y t e s $ , 

Char=NUM(Bytes*CBy te] ) 

I 

! Upper 4 bits form first ASCII char. 
Up_4_bi t5 = Char DIO 16 ! Shift risht 4 places. 
! Use numeric m a 1 u e as index into B c d _ c h a r s $ . 
First_char*=Bcd_char5$[Up_4_bits+l!l] 
! 

! Lower 4 bits form 2nd ASCII char. 

Lo_4_.bits = Char MOD 16 ! MasK upper 4 bits, 

! Use numeric u a 1 u e as index into B c d _ c h a r s $ , 

Second_char*=Bcd^char5$[Lo_4_bits+i;i] 

I 

! Now append characters onto format string, 
Disits$[2»Byte-n = Fir5t_char$&:Second-char* 
! 

NEXT Bvte 



Calc. SGNl's and SGN2's ASCII representations, 
S Sn 1 =B I T ( S 9n s _ an d _ u 1 d , 2 ) 

Ssnl*=CHR$(43+2*S3nl ) ! "+" if Loi "-" if Hi, 
Ssn2 = BIT(SSns_and_ouId .1) 

Ssn2«=CHR$(43+2*S3n2) ! "+" if Lo! "-" if Hi. 
I 

! Calc. Duerload's ASCII representation. 
Ould=BIT(Ssns_and_ould ,0) 

0uld$=CHR*(48+8*Duld) ! "0" if Lo; "8" if Hi. 
I 

Numbe r$ = SSnl$&,Di Si ts*[ 1 .5]&;"E"&:Sin2$&;Di Si ts$[6 ,83 

Funct i on$ = Oi.i Id$&:Di Si ts*C9 1 10] 

Fo rma t * = Numb e r*&: " i " &Fun c t i on$&:" " 

I 

RETURN ! ♦♦♦»♦** End of Subroutine. ******* 

I 

END 
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Entering with STATUS Statements 

The preceding examples assumed that thg handshake options available with the BCD Interface 
are compatible with your peripheral. This section shows examples of designing enter operations 
using STATUS and CONTROL statements to implement your own handshakes. 

100 E}cd = ll 

110 CALL Enter_by tes (Bed .BvtesJ) 

120 PRINT Bvtes* 

130 STOP 

lao > 
150 e;nd 

IBO s 

170 SUB Ente r_bytes ( Isc fReturn-St rins*> 

180 ! 

190 CONTROL Isc.ZH ! Initiate handshaKe. 

200 ! 

210 ChecK: STATUS I s o 1 1 i I n t r_5 1 at 

220 I rq = BIT( Int r_stat (B) 

230 IF NOT I rq THEN ChecK ! Wait for response. 

zao ! 

250 ! Now read bytes in registers 5 -> 9. 

2G0 STATUS 1 1 .5 ! R5 tRG .R7 .R8 .R9 

270 ! 

280 ! Return bytes as a strinS. 

290 Return_st rinS$ = CHR$(R5)&:CHR*(RS)&CHR$(R7> 

300 Return_st rinS* = Retijrn_st r i n J*&:CHR$ ( R8 ) &:CHR$ ( R9 ) 

310 ! 

320 iSUBEND 

Note that the program uses the Interrupt Request bit (bit 6 of register 1) to determine when the 
handshake is completed by the peripheral. This bit is cleared (0) when a Request is performed 
(i.e., when the handshake is initiated by writing a non-zero value to CONTROL register 2). The 
bit is set w hen the pe ripheral acknowledges the Control (CTLA/B) signal by responding with 
Data Flag (DFLGA/B). The acknowledgement occurs when the Control line is Cleared by the 
leading edge of Data Flag (Type 2 timing) or by its trailing edge (Type 1 timing). 

The transfer of data can also be implemented with interrupts, which is described in the BCD 
Interrupts section. 
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Entering Data from Two Peripherals 

Data can be entered from two devices by using either BCD-Mode Optional format or by using 
STATUS statements. Optional format allows up to 4 BCD digits from the first peripheral and up 
to 5 BCD digits from the second peripheral; overload from either device may also be detected. 
Data from each device is handshaked independently. 

Optional Format 

This section describes how to use the Optional format with BASIC programs. In order to use 
this format, the peripheral's handshake convention must be compatible with one of the hand- 
shake options available on the BCD Interface. Since the preceding section described how to 
implement handshake routines with STATUS and CONTROL statements, you should refer to 
that discussion if your application requires that type of solution. 

With the BCD-Mode Optional format, the data, sign, and overload signals are read and format- 
ted into ASCII characters in the following sequence: 



SGN1 DI4 



DI2 



DI6 



DI8 



SGN2 DUO DI1 



DI5 DI3 



DI7 



OVLD DI9 



LF 



The following program segment shows an example of how these characters might be entered, 
stored in variables, and printed. 



100 ENTER 11 ;Nu(nber_l »Number_2 
110 PRINT "Number 1= ";Ni.UTiber_l 
120 PRINT "Number 2= ";NurTtber_2 



The following results would be printed by the preceding program segment: 



N u I'll b e r 1 = 
N u iti b e r 2 = 



42B5 
■1537 



The ENTER statement calls the Optional-format driver, which reads the signals on the interface 
lines in the order shown and generates the approptiate ASCII characters. Characters are en- 
tered and sent to the "number builder" until the "," is read, which terminates entry into the 
variable Numbe r_l; the internal representation of the numeric value is then generated. The 
characters after the comma are used to build the value of Numb e r_2. The ENTER statement is 
properly terminated when the line-feed (an ENTER-statement terminator) is encountered. 

If a second variable would not have been included in the preceding ENTER .statement, ENTER 
would have continued asking the driver for characters until it encountered the line-feed, which 
terminates the statement. 



It is important to note that an "8" is generated by the driver when the OVLD line is true or 
when any of the bits of DI9 are true, making the possibilities of exponent values 0, 8, 80, or 88; 
consequently, the BASIC program must "separate" these overload indicators. 
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Separating overload information from the mantissa may be a problem when one number can 
be represented in two ways; for instance, ".0001E8" and "10000" both represent the value 
"l.OE + 4", but the two representations have entirely different meanings. The first representa- 
tion indicates an overload on the second device, while the second value does not. 

To solve this potential problem, the second number can be entered into a string variable, as 
shown in the following segment. 

100 ENTER 11 iNumber_l tNumtier_2* 

110 ! 

120 ! Separate 2nd mantissa and exponent. 

130 E:KPonent* = Nufflber_2$[8 t9] 

140 Nijmber_2* = Ni.imber_2$Cl .B] 

150 ! 

IGO ! Place 2nd mantissa in numeric variable. 

170 ENTER NLimber_2$!Number_2 

180 ! 

190 PRINT "Number l=";Number_l 

200 ! ChecK overload information. 

210 IF Exponent*[l !1 ] = "8" THEN 

220 PRINT "Duerload on device 1." 

230 PRINT 

240 EIMD IF 

250 ! 

2B0 PRINT "Number 2="iNumber_2 

270 ! ChecK overload information. 

280 IF Exponent$[2]="8" THEN 

290 PRINT "Overload on device 2." 

300 PRINT 

310 END IF 

320 PRINT 

330 ! 

340 END 

The program checks the exponent digits separately and indicates an overflow on either device. 

To contrast the preceding examples, suppose that the following statement has been executed: 
ENTEF? 11 USING "tt»K";Number 

In this case, the « specifier directs the ENTER statement to suppress its default requirement of 
looking for a line-feed character (or other statement-termination condition) to terminate the 
ENTER. Thus, the comma terminates both entry of data into Numbe r and the ENTER state- 
ment. Consequently, a subsequent ENTER statement would begin entering characters begin- 
ning with the character following the comma (i.e., the first character of the second number), 
which may not be the desired action. 

In such a case, several remedies are possible. The simplest is probably to go ahead and include 
a second variable so that the driver is left pointing to the first character after the ENTER is 
completed. The second variable is thus used for a "dummy" read operation. Another remedy is 
to write a non-zero value to BCD CONTROL register 1, which "resets" the driver pointer to the 
first character of the format (SGNl). Executing the following statement performs the driver 
reset. 

CONTROL 11 »1 5 1 
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This type of situation may also occur when the BCD device sends a line-feed as one of the BCD 
characters. 



SGN1 DI4 DI2 DI6 DI8 



SGN2 DUO DM DI5 DI3 DI7 



DI9 OVLD 



+ 


1 


2 


3 


LF 


, 


-h 





1 


5 


3 


LF 


E 





LF 



In such case, two numbers are sent separated by line-feeds. The following statements would 
read these two numeric values and then reset the driver pointer to the first character (the SGNl 
character). 

EMTER 1 1 iNumbe r_l tNumbe r_2 
CONTROL 11 ,1 il 



If the CONTROL statement had not been executed, the driver would have been left pointing to 
the "E" character. 
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Outputting Data Through the BCD Interface 

All data outputs through the BCD Interface are made through the eight output lines. There are 
two general methods of sending data to devices through the BCD Interface — by using CON- 
TROL statements and by using OUTPUT statements. With CONTROL statements, the data are 
latched on the output lines, but the handshake (if desired) must be performed with STATUS 
and CONTROL statements. With the OUTPUT statement, each data byte is sent individually 
under handshake control. With both methods, neither the setting of the Optional Format switch 
nor the current Mode (BCD or Binary) has any effect on how data are output through the 
interface. 

Output Routines Using CONTROL and STATUS 

Many applications do not require that data- be sent with a handshake operation. In such cases, 
the following example shows how one byte of data may be sent to the peripheral. 

100 Byte=2-S+2-4 ! Set Bits G and a. 

110 CONTROL 12»45Byte ! Send data w/o handshake. 

If your application requires a handshake which is not compatible with the handshake options 
available on the BCD Interface, you can program your own. The following program shows an 
example handshake. The transition of the Data Flag signal that Clears the Control signals is still 
determined by the setting of the CTLA-2 and CTLB-2 switches. See the configuration section 
for further details. 

100 Bcd=ll 

110 Chars$="lA2B" 

120 Eol$ = CHR*( 10) ! LF is EQL se=iueriCB. 

130 CALL OutPUt_bod(BGd .Chars* .Eol*) 

140 ! 

150 END 

IGO ! 

170 SUB 0utput_bcd( Isc tCharacte rs* .Eol$) 

180 ! 

190 OLitPUt_data* = Characters*&:Eol* 

200 FDR 1=1 TO LEN(OutPut_data*) 

210 CONTROL l5c.2il ! Initiate handshaKe. 

220 ! 

230 ! Now output b>'te(s) to resisters U , 

2a0 CONTROL I so .4 i NUM ( Out put-dat a$ [ I i 1 ] ) 

250 ! 

2G0 ! See if Ready for next bvtei 

270 ChecK: STATUS I s c . 1 i In t r_s t at 

280 I rq=BIT( Int r-stat »B) 

290 IF NOT I rq THEN CheoK ! Wait for response. 

300 ! 

310 NEXT I 

320 ! 

330 SUBEND 

The data are output on the Data Output lines in byte-serial fashion. The program uses the 
Interrupt Request indicator (Bit 6 of STATUS Register 1) to indicate the interface's and 
peripheral's joint readiness for a subsequent handshake operation. Interrupts can also be used; 
for more details, see the discussion of BCD Interrupts. 
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Sending Data with OUTPUT 

With the OUTPUT statement, data are output byte-serially, one byte per handshake cycle. The 
following program shows an example of outputting data through the BCD Interface. 



1 
1 1 
1 2 
130 

lao 

150 



Bcd=ll 

OUTPUT Bed i 123 .456 ."ABC" ,"DEF' 
OUTPUT Bed ;i23 .a5Bi"ABC" ;"DEF' 
OUTPUT Bed i"123" ,"45G" ! 

I 

END 



The following diagram shows the sequence of ASCII characters sent to the destination device 
with the preceding program. The notation indicates that each ASCII character is sent through 
the output lines DO-7 through DO-0. 



CR LF 



F EOL Characters 



1 


2 


3 


4 


5 


6 


A 


B 


C 


D 


E 


F 


EOL Characters 



1 


2 


3 


CR 


LF 


4 


5 


6 



Notice that when a comma follows an output item in a free-field OUTPUT statement, a numeric 
item in the output data is terminated by a comma and a string item is terminated by a CR/LF 
sequence (one carriage-return and one line-feed character). If an item is followed by a semicol- 
on, no item terminator is sent. If an item is the last one in the output list, an end-of-line (EOL) 
sequence is sent instead of the item terminator; the default EOL sequence is a CR/LF with no 
time delay. Changing the EOL sequence is described in Chapter 4. 

In the preceding program, the FORMAT ON attribute was in effect so the ASCII representation 
of each data item was generated and sent to the peripheral device. It is also possible to 
OUTPUT with FORMAT OFF in effect by using I/O path names. See Chapter 10 for further 
details. 

It is interesting to note that all handshake cycles latch both input and output data. In the 
following example, an OUTPUT statement is used to place one byte on the Data Out lines 
under handshake control. A STATUS statement is then used to read the Data In lines, since the 
handskake operation also latched the data on the input lines into STATUS Registers. 

100 B'/te = B4 + 32 ! Set bits G and 5. 

110 OUTPUT 11 USING "tt»B";Bv-te ! HandshaKe bvte 1 out. 

120 ! Now read SGN1» SGN2 > QK'LD t and DIl thru DUO. 

130 STATUS 11 »4iRe34 »Re35 »Re3G tRe37 tReSS »Re39 

laO S3nl=BIT(Re?4 »2) 

150 S3n2=BIT(Re34 »1 ) 

IGO Duld=BIT(Res4 »0) 

170 Dil=Re95 DIM IG 

180 Di2=ReS5 MOD IG 

190 Di3=Re3G DIU IG 

200 Di4=ReSB MOD IG 



The program determines the states of the sign, overload, and data lines. The data may then be 
formatted as desired. 
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BCD Interface Timeouts 

When a peripheral device does not respond to a handshake request from the computer, it is 
convenient to be able to sense this condition and respond accordingly. Using the ON TIMEOUT 
statement sets up and enables a branch which will be initiated when the computer determines 
that the interface has taken too much time to respond. 

Timeout events were generally discussed in Chapter 7. However, specific details such as the 
effects of the TIMEOUT event's occurrence on each interface and how the time parameter is 
measured were not described. This section describes such topics. 

Timeout Time Parameter 

When an ON TIMEOUT is set up for an interface, the time required to complete each hand- 
shake is measured and compared to the time specified in the ON TIMEOUT statement. The 
interval measured is shown in the following diagram. 



Type 2 
Timing 



Type 1 
TiniNG 



CTLR 



DFLGfl 



Clear 

Set 

Busy 

Ready 



iL iL 



Measuring the BCD Interface's TIMEOUT Parameter 



Timing begins when the CTLA and CTLB signals are placed in the Set state to initate a 
handshake cycle. The computer continues to check the time elapsed against the specified time 
(TIMEOUT time parameter). Timing ends when the peripheral has completed its response; with 
both Type 1 and Type 2 timing, this occurs only when the Control line is cleared and the Data 
Flag line is placed in the Ready state by the peripheral. 

Timeout Service Routines 

When a TIMEOUT occurs, the comp uter au tomatically executes an Interface Reset. The 
Periph eral Reset l ine to the peripheral (Preset) is pulsed low for at least 15 microseconds, and 
CTLA and CTLB are then Cleared. This action should "get the peripheral's attention", if it is 
functional. The service routine should then take the appropriate corrective action. See a pre- 
vious section called "Interface Reset" for further effects of the reset. 



Timeout service routines generally determine whether or not the peripheral is still functional. If 
so, the computer may take corrective action such as to re-initiate the preceding transfer. If not, 
perhaps the program may inform the operator of the condition and then proceed. 
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The following program shows an example of setting up a branch to a service routine upon 
detecting a TIMEOUT on the BCD Interface. When a TIMEOUT occurs while trying to send the 
first message, the service routine attempts to send an escape character to the peripheral, which 
here is a request for status of our fictitious peripheral. If the peripheral does not respond, the 
destination of data is changed to the CRT. 



10 

1 1 

12 
13 
14 
15 
IB 
17 
18 
19 
2 
21 

23 

2a 

25 
2B 
27 
28 
29 
30 
31 
32 
33 

3a 

35 
3B 
37 
38 
39 

ao 
ai 
a2 
as 



Bcd=ll ! Interface select code of 5CD, 
Dest=Bcd ! Destination is deuice is BCDi 
ON TIMEOUT Bod. 2 GOSUB T ry_bcd_a 3a i n 
I 

MBSsa9e$="This sent to BCD." 
OUTPUT Dest ;Messase$ 

If TIMEOUT) this line is executed upon RETURN. 

All subsequent data sent to Dest=CRT (if TIMEOUT). 
Messa9e$="This sent to CRT." 
OUTPUT Dest iMessase* 



STOP 
Try_bcd_a3ain: ON TIMEOUT Bed. 3 GOTO ForSet_it 



! See if escape character is accepted. 
OUTPUT Bed USING "« .B" 527 

If accepted, then 2nd TIMEOUT didn't occur; 

so this sesiiient misht contain a routine 

that interroSates peripheral. 

ON TIMEOUT Bed. 3 GGSUB T r y_bc d_a 3a i n 
GOTO Exit.point 



For3et_it! 



Exit_Point; 
END 



PRINT "BCD Down! Data will be sent to CRT." 

PRINT 

Dest = 1 

BEEP 

OFF TIMEOUT Bod ! No lonSer need active TIMEOUT, 

I 

RETURN ! to line followinS TIMEOUT'S occurrence. 
I 



The timeout service routine may be programmed to attempt to continue the transfer where it 
timed out; however, this action may be difficult to implement for two reasons: the computer 
may not be keeping track of where in the transfer the TIMEOUT occurred, and the automatic 
Interface Reset performed when the TIMEOUT occured may have also reset the peripheral. 
How your program implements the transfer and how the peripheral respond to the reset will 
determine the feasibility of continuing the transfer. 
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BCD Interface Interrupts 

The BCD Interface can detect one type of interrupt condition: an interrupt can be generated 
when the interface is Ready for a subsequent data transfer, which generally occurs after the 
program initiates a handshake and the peripheral completes it. 

Setting Up and Enabling Interrupts 

When an event occurs, the event is logged by the BASIC operating system. After the event is 
logged, any further interrupts from the interface are disabled until specifically re-enabled by a 
program. All further computer responses to the event depend entirely on the program. 

The following segment shows a typical sequence of setting up and enabling a BCD interrupt to 
initiate its branch. 

100 ON INTR 11 GOSUB Bcd_intr 

110 MasK=l 

120 ENABLE INTR mMask 

The value of the interrupt mask (Mask in the program) determines whether the interrupt is to be 
enabled or disabled. In this case, any non-zero value enables the Ready interrupt. 

Interrupt Service Routines 

Since there is only one type of interrupt possible with the BCD Interface, the service routine 
does not need to determine the interrupt cause. In general, all the service routine needs to do is 
to determine whether another data item is to be transferred or the transfer is to be terminated. 
The following program shows a typical interrupt service routine. 

100 Bod=ll 

110 ON INTR Bed GOSUB Get-bvtes 

120 ! 

130 CONTROL Bcd(2!l ! Initiate 1st handshaKe. 

lao ENABLE INTR Bcdil ! Enable Ready Interrupts. 

150 ! 

IBO ! Execute backsround routine. 

170 WHILE Iteration<l .E+G 

180 I t e rat i on= I te rat i on+l 

190 DISP Iteration 

200 END WHILE 

210 ! 

220 Get_b'/tes : ! 

230 STATUS Be d .5 i Re 45 .Re SB iRe S7 iRe S8 (Re SS 

240 PRINT ReS5 (Rese .ResfV .Res8 (Re39 

250 CONTROL Bcdi2il ! Initiate next handshaKe. 

2G0 ENABLE INTR Bed ! Re-enable (use same Mask). 

270 RETURN 

280 ! 

290 END 

The main program sets up the branch location, initiates the first data-transfer handshake, and 
then enables the interface to interrupt when it is Ready; the peripheral is Ready when it has 
cleared the Control line(s) and placed the Data Flag line(s) in the Ready state. 

The service routine reads the data on lines DIl through DUO, initiates the subsequent hand- 
shake, and then re-enables another Ready interrupt, since the mask parameter was not in- 
cluded, the last specified value (1) was used. 

Obviously, this is a very simplistic example; however, the main topics of using interrupts have 
been shown. Your routine may need to format the data, keep track of how many bytes have 
been transferred, and check for terminator characters. 
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Status Register 
Control Register 



Summary of 
BCD Status and Control Registers 

— Card Identification = 4. 

— Reset Interface (if non-zero value sent). 



Status Register 1 

Most Significant Bit 










Interrupt Status 

Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


Interrupt 

Are 
Enabled 


Interrupt 
Request 


Hardware Interrupt 
Level Switches 














Value = 128 


Value - 64 


Value - 32 


Value = 16 


Value = 


Value = 


Value = 


Value = 



Control Register 1 — Reset driver pointer (if non-zero value sent). 



Status Register 2 

Most Significant Bit 










Busy Bit 

Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 

















Handshake 

In 
Progress 


Interrupts 
Enabled 





Value == 


Value = 


Value = 32 


Valuer 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Bit is 1 when a handshake is currently in progress. 

Control Register 2 — Request data by Setting CTLA and CTLB (if a non-zero value is 

sent); this operation also clears an Interrupt Request (clears bit 6 of 

Status Register 1). 



Status Register 3 
Control Register 3 



— Binary Mode: 1 if the interface is currently operating in Binary 
mode, and if in BCD mode. 

— Set Binary Mode: set Binary Mode if non-zero value sent, and 
BCD Mode if zero sent. 
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Status Register 4 

Most Significant Bit 








s 


witch and Line States 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


OF 
Switch 
Is ON 


DATA 
Switch 
Is ON 


SGN1 
Switch 
Is ON 


SGN2 
Switch 
Is ON 


OVLD 
Switch 
Is ON 


SGN1 

Input 

Is True 


SGN2 

Input 

Is True 


OVLD 

Input 

Is True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Control Register 4 

Most Significant Bit 










Data Out Lines 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


Set 
DO-7 

True 


Set 
DO-6 
True 


Set 
DO-S 
True 


Set 
DO-4 
True 


Set 
DO-3 
True 


Set 
DO-2 

True 


Set 
DO-1 
True 


Set 
DO-0 

True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Status Register 5 



BCD Digits Dl and D2 



Most Significant 


Bit 












Least Significant Bit 


Bit 7 


Bite 


Bit 5 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit© 


DI1-8 

Is 
True 


DI1-4 

Is 
True 


DI1-2 

Is 
True 


DI1-1 

Is 
True 


DI2-8 

Is 
True 


DI2-4 

Is 
True 


DI2-2 

Is 
True 


DI2-1 

Is 
True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 


4 


Value = 2 


Value = 1 


Status Register 6 

Most Significant Bit 










BCD Digits D3 and D4 

Least Significant Bit 



Bit 7 


Bite 


Bit S 


Bit 4 


Bits 


Bit 2 


Bit 1 


BitO 


DI3-8 

Is 
True 


DI3-4 

Is 
True 


DI3-2 

Is 
True 


DI3-1 

Is 
True 


DI4-8 

Is 
True 


DI4-4 

Is 
True 


DI4-2 

Is 
True 


DI4-1 

Is 
True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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Status Register 7 



BCD Digits D5 and D6 



Most Significant Bit 










Least Significant Bit 


Bit? 


Bite 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI5-8 

Is 
True 


DI5-4 

Is 
True 


DI5-2 

Is 
True 


DI5-1 

Is 
True 


DI6-8 

Is 
True 


DI6-4 

Is 
True 


DI6-2 

Is 
True 


DI6-1 

Is 
True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Status Register 8 



BCD Digits D7 and D8 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI7-8 

Is 
True 


DI7-4 

Is 
True 


DI7-2 

Is 
True 


DI7-1 

Is 
True 


DI8-8 

Is 
True 


DI8-4 

Is 
True 


DI8-2 

Is 
True 


DI8-1 
Is 

True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



Status Register 9 



BCD Digits D9 and DIO 



Most Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit 


DI9-8 

Is 
True 


DI9-4 

Is 
True 


DI9-2 

Is 
True 


DI9-1 

Is 
True 


DI10-8 

Is 
True 


DI10-4 

Is 
True 


DI10-2 

Is 
True 


DI10-1 

Is 
True 


Valuer 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



The BCD Interface 443 



Summary of BCD READIO and WRITEIO Registers 

This section describes the BCD Interface's READIO and WRITEIO registers. Keep in mind that 
these registers should be used only when an operation cannot be performed with a STATUS or 
CONTROL statement. 

BCD RE- ADIO Registers 

Register 1 — Card Identification 
Register 3 — Interface Status 
Register 17 — DIl and DI2 
Register 19 — DI3 and DI4 
Register 21 — DI5 and DI6 
Register 23 — DI7 and DI8 
Register 25 — DI9 and DUO 
Register 27 — Peripheral Status 



READIO Register 1 

The contents of this register are always 4. 



Card Identification 



READIO Register 3 

Most Significant Bit 










Interrupt Status 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


BitO 


Interrupt 

Are 
Enabled 


Interrupt 
Request 


Hardware Priority 
(INT LVL Switches) 














Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 


Value = 


Value = 


Value = 



READIO Register 17 

H/lost Significant Bit 










DIl and DI2 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


BitO 


DI1-8 

Is 
True 


DI1-4 

Is 
True 


DI1-2 

Is 
True 


DI1-1 

Is 
True 


DI2-8 

Is 
True 


DI2-4 

Is 
True 


DI2-2 

Is 
True 


DI2-1 

Is 
True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 
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READIO Register 19 

Most Significant Bit 



DI3 and DI4 

Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


DI3-8 

Is 
True 


DI3-4 

Is 
True 


DI3-2 

Is 
True 


DI3-1 

Is 
True 


DI4-8 

Is 
True 


DI4-4 

Is 
True 


DI4-2 

Is 
True 


DI4-1 

Is 
True 


Value = 128 


Value = 64 


Value - 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



READIO Register 21 

Most Significant Bit 



Bit 7 



DI5-8 

Is 
True 



Valuer 128 



Bite 



DI5-4 

Is 
True 



Value = 64 



Bit 5 



DI5-2 

Is 
True 



Value - 32 



Bit 4 



DI5-1 

Is 
True 



Value = 16 



Bit 3 



DI6-8 

Is 
True 



Value = 8 



Bit 2 



DI6-4 

Is 
True 



Value -= 4 



DI5 and DI6 

Least Significant Bit 



Bit 1 



DI6-2 

Is 
True 



Value = 2 



Bit 



DI6-1 

Is 
True 



Value = 1 



READIO Register 23 

Most Significant Bit 



DI7 and DI8 

Least Significant Bit 



Bit 7 


Bit 6 


Bit 5 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit© 


DI7-8 

Is 
True 


DI7-4 
Is 

True 


DI7-2 
Is 

True 


DI7-1 

Is 
True 


DI8-8 

Is 
True 


DI8-4 

Is 
True 


DI8-2 

Is 
True 


DI8-1 

Is 
True 


Value = 128 


Value = 64 


Value - 32 


Value = 16 


Value = 8 


Value -= 4 


Value = 2 


Value = 1 



READIO Register 25 

Most Significant Bit 



Bit 7 



DI9-8 

Is 
True 



Value = 128 



Bit 6 



DI9-4 

Is 
True 



Value = 64 



Bits 



DI9-2 

Is 
True 



Value - 32 



Bit 4 



DI9-1 

Is 
True 



Value = 16 



Bits 



DI10-8 

Is 
True 



Value = 8 



Bit 2 



DI10-4 
Is 

True 



Value = 4 



DI9 and DUO 

Least Significant Bit 



Bit 1 



DI10-2 

Is 
True 



Value = 2 



Bit 



DI10-1 

Is 
True 



Value = 1 
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READIO Register 27 

Most Significant Bit 








Switch and Line States 

Least Significant Bit 


Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit 


OF 
Switch 
Is ON 


DATA 
Switch 
Is ON 


SGN1 
Switch 
Is ON 


SGN2 
Switch 
Is ON 


OVLD 
Switch 
Is ON 


SGN1 

Input 

Is True 


SGN2 

Input 

Is True 


OVLD 

Input 

Is True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



BCD WRITEIO Registers 

Register 1 — Reset Interface 

Register 3 — Enable Interrupt 

Register 5 — Output Data 

Register 7 — Initiate Handshake 

WRITEIO Register 1 — Reset interface (any value causes reset). 



WRITEIO Register 3 



Enable interrupt if Bit 7 Set (1); disable if Bit 7 Clear (0). 



WRITEIO Register 5 



Set Data Output Lines 



f^/lost Significant Bit 










Least Significant Bit 


Bit 7 


Bit 6 


Bits 


Bit 4 


Bit 3 


Bit 2 


Bit 1 


Bit© 


Set 
DO-7 
True 


Set 
DO-6 
True 


Set 
DO-S 
True 


Set 
DO-4 

True 


Set 
DO-3 
True 


Set 
DO-2 
True 


Set 
DO-1 
True 


Set 
DO-0 
True 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



WRITEIO Register 7 



Initiate handshake: sendi ng any val ue to this register initiates 
handshake cycle by setting CTLA and CTLB. 
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EPROM Programming 



Chapter 

18 



Introduction 

With HP Series 200/300 BASIC, erasable programmable read-only memory (EPROM) devices are 
generally used like other mass storage devices. However, EPROM can also be accessed as indi- 
vidual bytes or words of data. This chapter describes both types of usage. 

Accessories Required 

In order to program and read EPROM memory devices with HP Series 200/300 computers, you 
will need th<3 following HP accessories: 

• HP 98253 EPROM Programmer card 

• HP 98255 EPROM Memory card(s) and compatible EPROM devices 

Hardware Installation 

At this point, you should install the programmer and memory cards or verify that they have 
already been properly installed. The following manuals describe setting up your system to 
program EF'ROM devices. 

• HP 98253 EPROM Programmer Installation — describes setting the select code switches 
on the programmer card and installing the card. 

• HP 98255 EPROM Memory Installation — describes selecting compatible EPROM parts, 
loading the parts on the card, setting memory address switches, and installing EPROM 
memory cards. 

The first example program in the chapter describes how to interrogate EPROM Programmer 
and Memory cards to determine their current configurations (and also to determine whether or 
not both are operational before installing EPROMs in the memory boards). 
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Brief Overview of Using EPROM Memory 

EPROM memory is organized and accessed like other mass storage devices from BASIC. Briefly, 
programs and data can be stored in EPROM memory with the following procedure: 

1. Determine the EPROM Programmer card's select code. Determine the address of the 
EPROM Memory card to be programmed, relative to other cards' addresses, which deter- 
mines its mass storage unit number. 

2. INITIALIZE the memory unit, which writes directory and system information in the EPROM 
(see "EPROM Directories" for further information). 

3. Store the information using whichever one of the following statements is appropriate: 

CONTROL — store individual data words 
COPY — store any type of file 
SAVE — store the program as an ASCII fite 
STORE — store the program as a PROG file 
STORE KEY — store typing-aid keys in a KEY file 

4. Access the information with the corresponding one of the following stat(3ments: 

CAT — get a catalog listing of the files in the EPROM unit 
COPY — copy an EPROM file's contents into another file 
ENTER — enter data from a file into a program variable 
GET — load an ASCII program file into the computer 
LOAD — load a BIN, KEY, or PROG file into the computer 
LOADSUB — load SUB or FN subprograms from a PROG file 
TRANSFER — transfer data from data file to a memory BUFFER 
STATUS — read individual data words from EPROM memory 
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Initializing EPROM Memory 



Like other mass storage media, EPROM media must be initialized before being used for stor- 
age. Since EPROM Memory cards are organized as mass storage units, each card being one 
unit, EPROM memory must be initialized by units. The EPROM Programmer card is used to 
initialize and store other information in EPROM. This section describes how to specify EPROM 
units and programmer cards while initializing and accessing EPROM. 

EPROM Programmer Select Code 

The EPROM Programmer card is accessed like other interface cards: you must specify its select 
code in BASIC statements. The factory default setting of the select code is 27, which is the 
select code assumed in the examples in this section. (Setting the select code is described in the 
HP 98253 EPROM Programmer Installation manual.) As further explained later, you don't 
usually need to specify the programmer card's select code when reading data from EPROM. 

EPROM Addresses and Unit Numbers 

With the BASIC system, EPROM Memory cards should be given memory addresses 300 000 
through 3FF FFF (hexadecimal). The address switches on EPROM Memory cards can therefore be 
set in the range of 0011000 through 0011111, which result in hexadecimal base addresses of 
300 000 through 3E0 000, respectively, with intervals of 20 000 bytes (hex) between base addres- 
ses. When using addresses in this range, SW2 must be set to the "AD" position'. (Note that 
differences between base addresses of cards containing 27128 EPROMs must be at least 40 000 
hexadecimal. See the HP 98255 EPROM Memory Installation manual for further explanation.) 

At power-up, the system automatically gives unit numbers to all cards according to the initial- 
ized cards' relative memory addresses. The card with the lowest numbered address (which is 
initialized) is given unit number 0; the initialized card with the next higher address is given unit 
number 1, and so forth. (Note that un-initialized EPROM units are not given unit numbers by 
the system.) 

As an examiple, suppose that two EPROM Memory cards are properiy installed in the computer 
with hexadecimal base addresses of 300 000 and 380 000. Assume that they have already 
been initialized. At power-up, the former card will be given unit number and the latter will be 
given unit number 1. 

If an initialized card with base address 340 000 is then installed (with power off, of course), this 
card is given unit number 1 and the card at address 380 000 is given unit number 2 at 
power-up. (Note that, like disc media, the unit number is not written on the media. Unit 
numbers are a function of relative EPROM addresses only. ) 

It is a good idea to keep track of the addresses of all EPROM Memory cards in the system so that 
you will know the resultant unit number of each card. 



1 With computers which feature a MC58010 or MC68020 processor, this switch should be set to "GD" position. 
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Verifying Hardware Operation 

In order to INITIALIZE an EPROM unit, you will need to connect a programmer card to it. 
Connect the cable from the desired programmer card to the EPROM unit to be programmed; 
the power need not be turned off to make this connection. All EPROM devices on the unit to be 
initialized must be completely erased Also, the address of the EPROM card to be initialized 
must be higher than all other initialized EPROM cards in the system, which results in the card 
being given a unit number one greater than the largest unit number currently in the system. 

If you have been keeping track of memory addresses, you should know the unit number of 
EPROM Memory card to be programmed. If not, you can use the following program to deter- 
mine the address of each EPROM Memory card in the computer by plugging the connector into 
each memory card in succession. 



100 

1 1 
120 
130 

iao 

150 
IBO 
170 
180 
190 

2 
21C 
22C 
230 
ZH(. 
25C 
260 
270 
280 
290 

30i: 

310 

32i: 
33i: 
3ao 

350 

3Bi: 

3 70 
38t 

39i: 
l^oo 

410 

a2i: 
^3(: 
aao 
45(: 
asc 
47t: 
nee. 
aao 

500 
510 

52(: 
53(: 

540 
550 

56i; 
57i; 

580 
590 



! This proSrarn iriterroSates interfases at select codes 

! B thru 31 to find ari EPROM ProSramr/ier card. If one IS fourid 

! the prosram reads and displays its 'STATUS registers; if one 

! is NOT found) the program reports this neSatiue result. 

I 

! Clear screen, 

PRINT CHR$( 12) 



Sel_code=8 

F u n d _ c a r d = 

ON ERROR GOTO Ne x t _5 e 1 _c o d e 



! Start with select code 



! Goto next select code if 
! no interface at this one. 
REPEAT 

STATUS Sel_codeiId 
IF Id=27 THEN 
F u n d _ c a r d = 1 

PRINT "EPROM Programmer card found at Select Co d e " iSe 1 -C o d e 
PRINT 
END IF 
Next_5e l_code : IF NOT Found_card THEN Se 1 _co d e = Se l_c o d e + 1 
UNTIL Found_card=l OR Se 1 _c o de ) =3 1 
OFF ERROR 
I 

IF Found_card=0 THEN 

PRINT "EPROM Programmer card not found." 

PRINT "Prosram stopped." 

STOP 
END IF 
I 

I C h e c K to see if connected to memory card. 
STATUS Sel_code ,4 (Capacity 
IF Capacity=0 THEN 

PRINT "EPROM Programmer is NOT connected "i 

PRINT "to an EPROM Memory card" 

STOP 
END IF 
I 

! Read STATUS Registers thru G. 

STATUS Sel_code;Re3 0.ReSl iReS2,Res3,Re3aiRes5.ResG 

! 

! Show register contents. 

PRINT "STATUS Register 0:" 

PRINT " Card ID of EPROM Pro9rammer card="ild 

I 

PRINT "STATUS Register E:" 

PRINT USING "*>K,8D"i" Connected to EPROM card at address "iResG 

M5b_hex*=I0AL$(Re4B/6553B ilB) ! Get MSB's m hex. 

PRINT " ( " iMsb_hex$i:3 ,43 i "0 000 hexadecimal)" ! Trim leadinJ O's. 

I 

PRINT "STATUS ReSister 4:" 
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GOO 
GIO 
G20 
G30 

Gao 

G50 
GGO 
670 
GBO 
690 
700 
710 
720 
730 
740 
750 
7B0 
770 
780 
790 
800 
810 
820 
830 



PRINT 



M5b_hex$=iyAL*(Resa/G553G .IG) 



PRINT 



PRINT 
PRINT 



"STATUS Resister 5:" 

Number of oontisuaust erased by t es = " iRe S5 i 



PRINT 



PRINT 



Memory card 5i2e="iRe94i" bytes"! 



( " ;Msb_hex*[3 .4] !"0 000 hex)' 



Msb_hex*=IUAL*(Resa/B5536 .16) 

PRINT " ( " >l1sb_hex$[3 tfl] !"0 000 hex)" 

! 

PRINT 
PRINT 
! 

PRINT 
Word*=igAL$(ReS3 .IB) 



"STATUS Resister 2:" 

Current target address= 

STATUS Resister 3:" 



IRes; 



! Get MSB 's in hex . 
! Trim leadinS O's. 



! Get MSB's in hex, 
! Trim leadinS O's. 



Word at current tarSet addres5=";Res3!" ("iWord*!" hex)' 



'STATUS Resister 1:" 
IF Resl=0 THEN 

PRINT " ProSramminS time = 52.5 ms" 
ELSE 

PRINT " ProsramminS time = 13.1 ms" 
END IF 
! 

END 



The following display is a typical result of running the program. 

EPROM Prosraiiuiier card found at Select Code 27 

STATUE3 Resfister 0: 

Card ID of EPROM Programmer card= 27 

BTATUE5 Resister B: 

Connected to EPROM card at address 3145728 (300 000 hexadecimal) 

STATUE5 Resister 4: 

Memory card size= 2G2iaa bytes (040 000 hexadecimal) 

STATUS Resister 5: 

Number of contiguous* erased b y t e s = 

STATUS Resister 2: 

Current t a r S e t a d d r e s s = 

STATUS Resister 3: 

Word at current tarSet addres5= -1 (FFFF hex) 

STATUS Resister 1: 

ProsramminS time = 52.5 ms 



The program interrogates interfaces until it finds an EPROM Programmer card. It then prints the 
values of the Programmer card's STATUS registers. Register 6 shows the memory address of 
the EPROM Memory card to which the programmer card is connected. The program also shows 
that it can determine the type of EPROM devices being used on the card (2764's or 27128's). 

The "target address" register points to the memory location (an offset address to the card's 
base address) at which the next word of data will be read (STATUS register 3) or written 
(CONTROL register 3). Target address is the first word on the EPROM card. STATUS register 
1 indicates which programming time will be used (for each word) during subsequent 
programming operations; indicates a program time of 52.5 milliseconds, and 1 indicates 13.1 
milliseconds. 
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Initializing Units 

To INITIALIZE an EPRQM unit, you must specify the select code of the EPROM Programmer 
card and the unit number of the EPROM Memory card. For instance, the following statement 
initializes the memory with unit number through the programmer card at select code 27. 

INITIALIZE " :EPROM »27 MJ" 

Because the unit number defaults to if not specified, an equivalent statement would be: 



INITIALIZE 



lEPROM f27" 



An error is reported if the specified programmer card is not connected to the specified EPROM 
unit. Furthermore, if the specified EPROM memory unit is not completely erased, error 66 
(INITIALIZE Failed) is reported. Note that the entire card need not be filled with EPROMs 
for it to appear as entirely erased, since empty sockets and erased EPROM memory read as 
"FF" data bytes. The following simple program determines whether or not the EPROM unit 
contains all erased EPROMs (or erased EPROMs and empty sockets). 



10 CONTROL 27>2;0 ! Set target address to first byte. 

20 STATUS 27 j4 ?Tatal_capacity (Erased-bvtes 

30 PRINT "EPROM card is " i 

40 IF Total_capacity=Erased_bytes THEN 

50 PRINT "completely erased (or empty)." 

GO ELSE 

70 PRINT "NOT completely erased." 

80 END IF 

90 END 

EPROM Directories 

The INITIALIZE operation writes a directory and system information in the EPROM unit. This 
information occupies the first "sectors" of EPROM memory (since the unit is treated like mass 
storage, it is logically divided into 256-byte records known as sectors). The following table 
shows how the BASIC system allocates EPROM sectors. 



EPROM 
Type 


Usable 
Sectors 


Sectors for 
System Use 


Sectors 
for User 


Maximum No. 
of Files 


2764 
27128 


511 
1023 


0-6 
0-11 


7 - 510 
12 - 1022 


40 
80 



Note that the figures given for Total Sectors and Sectors for User are for fully loaded memory 
cards. Note also that the Total Sectors is one less than you may have expected, which shows 
that one sector is required by the system for overhead. 
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EPROM Catalogs 

Performing a CAT of the EPROM card reveals that it has been initialized. You can either specify 
the select code of the programmer card or use, 0, since reading the EPROM card does not 
require the programmer card be connected to it. However, if you do specify a select code, then 
that programmer card must be connected to the specified EPROM unit, or error 72 will be 
reported. The following statements perform the sanje function (specifying select code 27 would 
change the first line of the catalog listing accordingly): 

CAT ": EPROM >0" 

or 
CAT "sEPR0M»27" 



:EPROM»0 

MOLUME LABEL: 59836 

FILE NAME PRO TYPE REC/FILE BYTE/REC ADDRESS 



This directory has the same general format as internal-disc directories, which are described in 
Chapter 7, "Data Storage and Retrieval," of BASIC Programming Techniques. You can also 
perform all operations on EPROM directories that. you you can with other mass storage direc- 
tories (such as SKIP and COUNT files and CAT individual PROG files). 



Programming EPROM 

Once an EPROM unit is initialized, you can store data and programs in it. The following storage 
operations are supported for EPROM memory: 

• CHECKREAD — direct the system whether to perform an additional verify operation after all 
operations that write to mass storage 

• CONTROL — store individual data words in EPROM 

• COPY — copy any type of file (that already exists on another mass storage device) into 
EPROM 

• SAVE — store the current program in an ASCII file 

• STORE — store the current program in a PROG file 

• STORE KEY — store the current typing-aid keys in a KEY file 

Using these statements is described in the following sections of this chapter. The topic of reading 
EPROM information is described in a subsequent section. 
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Storing Data 

As a simple example of storing a data file in EPROM, suppose that you want to store the date 
that the EPROM was initialized and the current number of EPROM chips on the card in EPROM 
memory. The following program shows a simple example of how you might perform this 
operation. 



1 
110 
120 
130 
1^0 
150 
IGO 
170 
180 
190 

2 
210 
220 
230 
240 
250 
2G0 
270 
280 
230 
300 
310 
32 
330 
340 
350 
3G0 
370 
380 
390 
400 
410 
420 
430 
440 
450 
4G0 
470 
480 
490 
5 
510 
520 
530 



This proSram stores the Date that the 
EPROM Memory unit was initialized. 
(An EPftOM file name shows the date.) 



Select EPROM mass 
Pro3mr_5c=27 
U n i t _ n = 
E prom.iiis us $=": EPROM i 

to 



storage unit. 

"6:MftL$( ProSmr_5c ) &■.' 
write in EPROM. 



'&:OAL$(Unit_rio ) 



! Determine date 
Correct- date=0 
REPEAT 

DISP "Enter date to be stored in EPROM "i 

DISP "(Press ENTER for time shown)." 

OUTPUT KBDiDATE$(TIMEDATE) ; 

ENTER KBD;Date_* 

SET TIMEDATE DATE ( Da t e_* ) ! Set date, 

DISP "Is this correct? " ;DATE$ ( TI MED ATE ) 

ENTER KBD;Aris$ 

IF UPC$( Ans$[l .1 ] ) ="Y" THEN Co r re c t_d at e = 1 
UNTIL Correct- date 
DISP 

Format Date_$ from "DD MMM YYYY" 

to "MMM_DD_YY". 
Month$=Date_*C4,G] 

Day$=TRIM$(Date_$[l)23) ! Strip leading space 
Year* = Date_$C 10 (1 1 ] ! Remote "19" from year. 
F i 1 e _ ri a m e * = M n t h $ & " _ " &: D a y * &; " _ " & Y e a r $ 



(if one) 



Crea 
(use 
with 
D i s _ m 
CREATE 
! 

! Writ 
COPY F 
PURGE 
! 

! Now 
CAT Ep 
I 

END 



te a one-record ASCII file on the internal disc 

an external disc with Model IG) 

the DATE as the file's name, 
sus$=" : INTERNAL" 

ASCII File_naiiie*&:Disc_(iisus$ ,1 ! Error if file exists, 

e info into EPROM file. 

1 1 e _ n a rn e * & D i s c _ m s u s $ TO F i 1 e _ n a m e $ 8. E p r o m _ m s u s $ 

File_name$5:Disc_m5u5$ ! Remoue disc file after use. 

read date with cataloS of file names, 
r m _ m s u s $ 



The program first prompts for the EPROM unit number (the programmer card is assumed to be 
at select code 27). The program then prompts for the date by presenting the current clock date 
to the user on the keyboard input line. The user can either modify the date or accept it as it is 
shown. 



Assuming that the program is run on a Model 226 or 236, the program stores this information in 
an ASCII file on a disc in the internal drive. (It would be much faster to store the file in a 
MEMORY volume or in Bubble memory. ) This information is then stored in EPROM, and the 
internal ASCII file is purged. 
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Data Storage Rates 

The information is stored in EPROM at a approximately the following rates (program time is set 
by writing to CONTROL register 1): 



Program 
Time 



13.1 ms 
52.5 ms 



Seconds per 
Sector 



2 

7 



Bytes per 
Second 



150 
38 



Note that these times are for COPY, SAVE, and STORE operations. The storage rate when 
using CONTROL is lower slightly than these figures. 



Determining Unused EPROM Memory 

A potential problem with the example program in the preceding section is that there are times 
when you are not sure whether or not there is enough erased EPROM memory to store your 
information. Unfortunately, the system generally cannot determine beforehand whether there 
is sufficient room left in an EPROM unit to store the information it has been directed to store. 
This consequence is due to the fact that both blank sockets and erased EPROM memory read as 
all I's (hexadecimal FF bytes). The system can, however, determine when there is not enough 
room left on a fully loaded card (Error 64 is reported). 

Thus, when the system is directed to store data in EPROM, it begins programming the EPROMs 
one word at a time at the "next available" location. After each word is programmed, the system 
reads the word and compares it to what was to be written; this operation is known as "verify- 
ing" the word. An error will be reported when the word is not verified (such as when a blank 
socket, a previously programmed word, qr other hardware failure has been reached). So before 
you attempt to store any information in EPROM memory, you should determine whether or not 
there is enough erased memory to hold the data. 

Then general method of determining whether or not an EPROM memory unit has enough 
erased space to store your information is as follows: Determine the total number of usable 
sectors on the EPROM card, and then subtract the number already used. The result is the 
number of sectors available for storing additional information. This procedure is broken down 
into steps as follows (an example follows the procedure): 

1. Determine the number of usable sectors on the EPROM card. 



a. 



Determine the number of usable sectors of EPROM by using the following formulas: 

Total Sectors = (Chips on card)*(Bytes/Chip)*(l Sector/256 Bytes) 
Usable Sectors = Total Sectors — 1 sector (used by the system) 

in which: Bytes/Chip = 16 384 (for 27128's) 

= 8 192 (for 2764's) 

Use the CAT statement to determine how many EPROM sectors are already being 
used by files (already programmed). 
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2. Determine the number of sectors required to store your information. 

a. For ASCII data files, this number will simply be the number of records specified in 
the CREATE ASCII statement that created the file. 

b. For BDAT data files, multiply the number of records in the file by the record size 
(default = 256 bytes), divide this product by 256, and round any non-integer result 
to the next larger integer. Add one to this result to account for the sector used by the 
system (for EOF pointer and number of records). 

c. For programs, place the information in a mass storage file using STORE or SAVE 
(MEMORY volumes and BUBBLE memory are best suited for this purpose). Use the 
CAT statement to determine how many 256-byte sectors were required to store the 
information. 

d. For all other types of files, a quick look at the directory of the media on which the file 
is presently stored shows how many sectors are required to store the file. 

3. Compare the amount of usable memory in EPROM to the amount of memory required 
for your information. If there is sufficient memory, perform the storage operation. Other- 
wise, use another EPROM unit or mass storage device. 

As an example, suppose that you want to store a BDAT file that contains 20 records of 20 bytes 
each in EPROM. Since 20*20 = 400, and 400/256 = 1.5625 (which rounds up to the next 
larger integer of 2), two sectors of EPROM are required for the data. Add one sector for system 
use. Therefore, three sectors are required to store the file. 

To determine how much EPROM memory is available, first calculate the total number of sectors 
on the card. For this example, suppose that only two 27128 chips are on the board. The total 
number of sectors on the card is calculated by applying the preceding formula: 

Total sectors = 2 * 16 384 / 256 = 128 

Usable sectors = Total sectors - 1 === 127 

To see how many sectors have already been used, perform a CAT of the EPROM card; assume 
EPROM unit 0. 

CAT ":EPROM»0" 

: EPROM tO 

UQLUME LABEL: B983G 

FILE NAME PRO TYPE REC/FILE BYTE/REC ADDRESS 

Mar_a_83 ASCII 1 25G 12 
EPROM_BITS ASCII 17 25G 13 
EPROM_INIT ASCII 11 25G 30 

The CAT reveals that the last file begins at sector 30 and is 11 sectors in length. Thus, the next 
unused sector begins at sector 41. Since sector addresses start at 0, 42 sectors have already 
been used. Assuming that you have not written any data in subsequent sectors (such as with the 
CONTROL statement), there are 85 ( = 127-42) sectors of unused EPROM remaining. The 
BDAT file can be stored in the unit. 
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Storing Programs 

Storing programs in EPROM is a simple operation. Like storing programs in other mass storage 
media, you can use either the STORE statement or the SAVE statement. The one you will use 
depends on whether you want the program to be stored in a PROG or an ASCII file; the STORE 
statement stores the program in a PROG file, while the SAVE statement stores it in an ASCII 
file. If the program is already stored on another device, use the COPY statement. 

Compiled Pascal subprograms, or "CSUBs," can also be stored in EPROM with COPY. For 
instructions on how to write these compiled subprograms, see the CSUB Utility manual. 

As with storing data files, you must ensure that there is enough memory on the card to hold the 
program. First execute a CAT operation on the EPROM unit to determine how many sectors are 
unused. Then determine how many sectors will be required to store the program by using 
STORE or SAVE to store the program on another mass storage device. If there is enough 
unused EPROM memory, execute STORE or SAVE with the destination as the desired EPROM 
unit. For instance, the following statements are typical ways to store programs in EPROM. 

STORE "Pro3_l :EPROM >27 ,0" 
SAUE "Prod_l:EPROM»27" 

Programming Individual Words and Bytes 

You can also program individual words and bytes in EPROM with the BASIC system. However, 
you should not use these techniques to program EPROMs which are to be used as mass storage 
"units" in this manner. In other words, if you are going to access the EPROM with mass storage 
statements, use only operations such as SAVE, STORE, and COPY to program the EPROM 
unit. If the EPROM is to be for another purpose, such as to store machine-language code in 
another system, you can use these techniques to program the EPROMs. 

To program individual words, use CONTROL to set the target address and then write the 
desired word at that address. Repeat this process for as many words as you need to write. Note 
that you need to set the target address before every write operation. If you don't, an error will 
be reported. 

The automiatic verify operation is still performed for each word written into EPROM memory. 
The following example program shows how you might perform this type of operation; the first 
16 384 bytes of the EPROMs in sockets marked "OU" and "OL" are programmed. (The 
program takes approximately eight minutes to run. ) 



Assume data source is a BOAT file that contains exactly 
8192 INTEGER elements (written with FORMAT OFF). 



100 

110 

120 

130 ASSIGN eSource TO "EPROMWORDS ; I NTERNAL" 

140 INTEGER In t_a r ray ( : 819 1 ) 

150 ENTER BSource i Int_array (*) 

ISO ! 

170 ! Write BK words (ISK bytes). 

180 FOR Addr=0 TO 1B382 STEP 2 

190 CONTROL 27 .2 i Add r » In t_a r ray ( Ad d r/2 ) ! Write to EUEN addresses. 

200 NEXT Addr 

210 ! 

220 END 
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Notice that the target address (CONTROL register 3) begins at an even address (0) and is 
incremented by two for each subsequent word. Attempting to program a word at an odd 
address will generate an error. 

To program individual bytes, you will need to mask the byte that is not to be programmed. For 
instance, suppose that you want to insert one EPROM chip in the board and program it with 
data bytes. Inserting the chip in one of the sockets marked with an "L" gives the memory odd 
addresses. The program will need to be modified so that it writes only the least significant eight 
bits of each word (since you can only program words, which begin at even addresses). 

To program only the least significant byte, you would make the most significant byte all I's so 
that the program operation will verify (remember that empty sockets and erased bits read as all 
I's). The following program shows an example of programming single bytes of data in the 
EPROM located in the socket marked "OL." Note that the only difference between this prog- 
ram and the previous one is the manipulation of the upper eight bits of each integer. 



100 
110 
120 
130 

lao 

150 
IBO 
IGl 
1G2 
1G3 
170 
180 
181 
180 
200 
210 
22 



Assume data source is a BOAT file that contains exactl) 
8182 INTEGER elements (written with FORMAT OFF). 



ASS 
INT 
ENT 
I 

! D 
FfO 

I 

! 14 

FOR 
L 
C 

NEX 

! 

END 



IGN eSource TO " EPROMBYTES : I NTERNAL" 
EGER Int_array (0:8191 ) 
ER @Source!Int_array(*) 

efine mask for upper 8 bits. 
0=IOAL( "FFOO" ,1G) 

rite 8K bytes. 

Addr=0 TO 1G382 STEP 2 ! Must still write to EUEN addresses. 
ow_tiyte = BINIDR(FfOO ,Int_array ( Addr/2) ) ! MSB = FF ( LSB = unc h an 9e d ) 
ONTROL 27 ,2iAddr .Law_byte 
T Addr 



To program bytes of an EPROM located in a socket marked "U", you would left-shift the 8-bit 
value by eight places (which shifts the least significant byte to the most significant byte). For 
instance, the following statement shifts the least significant byte to the most significant byte and 
then makes the least significant byte all I's: 



Hi3h_byte = BINIOR(BHIFT(Low_byte »-8) »255) 



Programming EPROM with such eight-bit values writes the eight bits into EPROM devices at 
even addresses (i.e., in sockets marked with "U"). 
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Operations Not Allowed 

Once data is written in EPROM, it cannot be selectively erased (without erasing the entire 
EPROM device). Consequently, the following mass storage operations are not allowed for 
EPROM mass storage: 

CONTROL (cannot be used to write to registers 7 and 8 of an I/O path name assigned to a 

BOAT file) 
CREATE ASCII 
CREATE BOAT 

COPY (of an entire mass storage unit into EPROM) 
OUTPUT 
PROTECT 
PURGE 
RENAME 
RE-SAVE 
RE-STORE 
RE-STORE KEY 
TRANSFER (to an EPROM file) 
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Reading EPROM Memory 



After an EPROM unit has been programmed, you can perform the following operations to read 
the information: 

• CAT — get a catalog listing of the files in an EPROM unit 

• COPY — copy an EPROM file's (or unit's) contents into another file (or unit) 

• ENTER — enter data from an ASCII or BOAT data file into program variables 

• GET — load an ASCII program file into the computer 

• LOAD — load a BIN, KEY, or PROG file into the computer 

• LOADSUB — load SUB or FN subprogram(s) from a PROG file 

• TRANSFER — transfer data from a BOAT data file into a memory BUFFER 

• STATUS — read individual data words from EPROM memory 

Retrieving Data and Programs 

Reading data files stored in EPROM is similar to reading data files stored in other mass storage 
devices; the only difference is the mass storage unit specifier (msus), which will be of the form 
: EPRDM »Se 1 e c t _co d e » (J n i t _ri um b e r. Remember that both Select_code and 
Uni t_riu(r)be r parameters can be any type of numeric expression. Also keep in mind that 
when reading EPROM units you do not need to specify the select code of the EPROM program- 
mer card; you can specify a select code of 0. However, if you do specify the programmer card's 
select code, it must be connected to the specified EPROM unit. If the unit number parameter is 
omitted, a default value of is used. 

The broad subject of using ENTER to read data files is discussed in the BASIC Programming 
Techniques manual. This manual discusses the ENTER statement in detail, and also describes using 
the TRANSFER statement to transfer the contents of data files into memory BUFFERs. 

Like reading data files, retrieving programs from EPROM is identical to performing these 
operations from other mass storage devices. Refer to the BASIC Programming Techniques 
manual. 
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Summary of EPROM Programmer 
STATUS and CONTROL Registers 



STATUS Register 

Most Significant Bit 



ID Register 

Least Significant Bit 



Bit 7 


Bite 


Bits 


Bit 4 


Bits 


Bit 2 


Bit 1 


Bit© 











1 


1 





1 


1 


Value = 128 


Value = 64 


Value = 32 


Value = 16 


Value = 8 


Value = 4 


Value = 2 


Value = 1 



This register contains a value of 27 (decimal) which is the ID of an 
EPROM Programmer card. 

CONTROL Register — Interface Reset 

Writing any non-zero value into this register resets the card; writ- 
ing a value of zero causes no action. 



STATUS Register 1 — Read Program Time 

A value of indicates that the program time is 52.5 milliseconds 
for each 16-bit word (default); a non-zero value indicates that the 
program time is 13.1 milliseconds. 



CONTROL Register 1 



Set Program Time 

Writing a value of into this register sets the program time to 
52.5 milliseconds for each 16-bit word; any non-zero value sets 
program time to 13.1 milliseconds. 



STATUS Register 2 



Read Target Address 

This register contains the offset address (relative to the card's 

base address) at which the next word of data will be read (via 

STATUS Register 3) or written (via CONTROL Register 3). The 

default address is 0, which is the address of the first byte on the 

card. 



CONTROL Register 2 



Set Target Address 

Writing to this register sets the offset address at which the next 
word of data will be read (via STATUS Register 3) or written (via 
CONTROL Register 3). The target address must always be an 
even number. 
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Summary of EPROM Programmer 
STATUS and CONTROL Registers (cont.) 



STATUS Register 3 



Read Word at Target Address 

This register contains the 16-bit word at the current target 

address. 



CONTROL Register 3 



Write Word at Target Address 

Writing a data word to this register programs a 16-bit word at the 
current target address. The target address must be set (via CON- 
TROL register 2) before every word is written. Automatic veri- 
fication is also performed after the word is programmed. 



STATUS Register 4 



CONTROL Register 4 



Current Memory Card Capacity (in bytes) 

This register contains the current capacity of a fully loaded card in 
bytes; it also indirectly indicates which type of EPROM devices 
are being used on the card. If 262 144 is returned, then 27128 
EPROMs are being used; if 131 072 is returned, then 2764 de- 
vices are being used. A is returned if the programmer card is not 
currently connected to any EPROM memory card. 

Undefined. 



STATUS Register 5 



Number of Contiguous, Erased Bytes 

Reading this register causes the system to begin counting the 
number of subsequent bytes, beginning at the current target 
address, that are erased (or are empty socketsl. The counting is 
stopped when a programmed byte (i.e., one containing at least 
one logical 0) is found or when the end of the card is reached. If 
the byte at the current target address is not FF, then a count of 
is returned. Error 84 is reported if the programmer card is not 
currently connected to any EPROM card. 



CONTROL Register 5 — Undefined. 



STATUS Register 6 



Base Address of EPROM Memory Card 

This register contains the (absolute) base address of the EPROM 
memory card to which the programmer card is currently con- 
nected; this base address is also the absolute address of the first 
word on the card. Error 84 is reported if the programmer card is 
not currently connected to any EPROM memory card. 



CONTROL Register 6 — Undefined. 



463 



Useful Tables 



Appendix 



Option Numbers 



1 


BASIC Main 


19 


ERR 


2 


GRAPH 


20 


DISC 


3 


GRAPHX 


21 


CS80 


4 


10 


22 


BUBBLE 


5 


BASIC Main 


23 


EPROM 


6 


TRANS 


24 


HP 9885 


7 


MAT 


25 


HPIB 


8 


PDEV 


9 


XREF 


9 


XREF 


27 


RS232 


10 


KBD 


28 


GPIO 


11 


CLOCK 


29 


BCD 


12 


LEX 


30 


DCOMM 


13 


BASIC Main 


31-39 


Reserved 


14 


MS 


40 


"PHYREC" 


15 


SRM 


42 


CRTB 


16-18 


Reserved 


43 


CRTA 



Interface Select Codes 

Internal Select Codes 

1 Display (alpha) 

2 Keyboard 

3 Display (graphics) 

4 Internal floppy-disc drive 

5 Optional powerfail protection interface 

6 Display (Graphics for bit mapped) 

7 HP-IB interface (built-in) 

32 Parity, Cache, and Float (Pseudo Select Code) 

Factory Presets for External Interfaces 



8 HP-IB 

9 RS 232 

10 (not used) 

11 BCD 

12 GPIO 

14 HP-IB Disc Interface 

20 Data Communications 

21 Shared Resource Management 

27 EPROM Programmer 

28 Color Output 
30 Bubble Memory 
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Master Reset Table 





Power 
On 


n 

> 


1 

I 


X 
n 


RESET 


Note 2 
END 

STOP 


LOAD 


LOAD 
&Go 


GET 


GET 
&Go 


g 

CO 


Main 
Prerun 


SUB 

Entry 


SUB 
Exit 


CRT 






























CRT DISP Line 


Clear 


Clear 


- 


- 


Clear 


- 


- 


- 


- 


" 


— 


~ 


— 


— 


CRT Display Functions 


Off 


Off 


- 


- 


- 


- 


- 


- 


— 


- 


— 


— 


— 


~ 


CRT Mes&ige Line 


Ready 


Clear 


Clea- 


Clear 


Reset 


- 


- 


- 


- 


— 


- 


Clear 


— 


— 


CRT Input Line (Note 6) 


Clear 


Clear 


Clea- 


- 


Clear 


- 


- 


- 


— 


— 


~ 


— 


— 


— 


CRT Printout Area 


Clear 


Clear 


- 


- 


- 


- 


- 


- 


~ 


— 


- 


- 


— 


— 


CRT Print Position (TABXYl 


LI 


1.1 


- 


- 


Note 15 


- 


- 


- 


- 


- 


- 


— 


- 


— 


ALPHA ON/OFF (Note 3) 


On 


On 


On 


On 


On 


On 


- 


- 


- 


- 


— 


— 


— 


— 


KEYBOARD 






























Keyboard Recall Buffer 


Clear 


- 


- 


- 


- 


- 


- 


- 


- 


- 


— 


~ 


— 


— 


Keyboard Result Buffer 


Empty 


Empty 


- 


- 


- 


— 


— 


- 


— 


~ 


— 


— 


— 


— 


Keyboard Knob Mode 


t 


t 


: 


I 


t 


- 


— 


~ 


— 


— 


— 


— 


— 


— 


Tabs On Input Line 


None 


None 


- 


- 


- 


- 


- 


- 


— 


— 


— 


— 


— 


— 


Typing Aid Labels 


Note 16 


Note 16 


-■ 


- 


- 


- 


- 


- 


- 


- 


- 


— 


— 


— 


Keyboard Kataltana Mode 


Off 


Off 


Off 


- 


Off 


" 


- 


- 


- 


— 


— 


~ 


— 


— 


SUSPEND INTERACTIVE 


Off 


Off 


Off 


Off 


Off 


Off 


Off 


Off 


Off 


Off 


- 


Off 


- 


— 


PRINTING 






























Print column 


1 


1 


- 


- 


1 


- 


- 


- 


- 


- 


- 


— 


— 


— 


PRINTALL 


Off 


Off 


- 


- 


Off 


- 


- 


- 


- 


- 


- 


- 


— 


— 


PRINTALL IS 


1 


1 


- 


- 


- 


- 


- 


- 


- 


~ 


- 


— 


— 


— 


PRINTER IS 


1 


1 


- 


- 


- 


- 


- 


™ 


- 


- 


- 


— 


— 


— 


ENVIRONMENTS & VARIABLES 






























Allocated Variables 


None 


None 


None 


None 


Note 1 


Notel 


None 


None 


None 


None 


- 


None 


None 


Pre-ent 


Normal Variables 


None 


None 


None 


None 


- 


- 


None 


None 


None 


None 


- 


Note 11 


Note 1 1 


Pre ent 


COM Variables 


None 


None 


- 


None 


— 


- 


- 


Note 9 


- 


Note 9 


- 


- 


- 


- 


OPTION BASE 











— 


— 


- 


— 


Note 9 


- 


Note 9 


- 


Note 9 


Note 9 


Pre ent 


I/O Path Names 


None 


Closed 


Closed 


Closed 


None 


Closed 


Closed 


Closed 


Closed 


Closed 


- 


Closed 


- 


sub cisd 


I/O Path Names in COM 


None 


Closed 


— 


Closed 


None 


~ 


Note 10 


Note 10 


Note 10 


Note 10 


- 


- 


- 


- 


Keyboard Variable Access 


No 


No 


No 


No 


Main 


Main 


No 


In cnt. 


No 


In cnt 


In cnt 


Main 


SUB 


Pre-ent 


BASIC Program Lines 


None 


None 


None 


— 


- 


- 


Note 4 


Note 4 


Note 4 


Note 4 


Note 4 


- 


- 


- 


BASIC Program Environment 


Main 


Main 


Main 


Main 


Main 


Main 


Main 


Main 


Main 


Main 


- 


Main 


SUB 


Pre-ent 


Normal Binary Programs 


None 


None 


- 


- 


- 


- 


Notes 


Notes 


- 


- 


- 


- 


- 


- 


SUB Stack 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


- 


Clear 


Push 


Pop 


NPAR 
































- 





Actual 


Pre-ent 


CONTINUE Allowed 


No 


No 


No 


No 


No 


No 


No 


Yes 


No 


Yes 


Yes 


Yes 


Yes 


Yes 


ON < event > ACTIONS 






























ON <event> Log 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


- 


Empty 


Notes 


Notes 


System Priority 

















Q 














- 





Note 7 


Pre-ent 


ON KEY Labels 


None 


None 


None 


None 


None 


None 


None 


None 


None 


None 


- 


None 


- 


Pre ent 


ENABLE/DISABLE 


Enable 


Enable 


Enable 


Enable 


Enable 


Enable 


Enable 


Enable 


Enable 


Enable 


- 


Enable 


- 


- 


KNOBX & KNOBY 

















n 














- 





- 


- 
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5 


i 


n 

5 




Note 2 










5 










Power 
On 


> 


n 


RESET 


END/ 
STOP 


LOAD 


LOAD 
&Go 


GET 


GET 

&Go 


1 


Main 
Prerun 


SUB 
Entrv 


SUB 

Exit 


MISC. 






























GOSUB Stark 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


_ 


Clear 


Local 


Pre-ent 


TIMEDATE 


Note 14 


— 


— 


— 


— 


— 


— 


— 


— 


— 


— 


_ 


_ 


— 


ERRL, ERRN, and ERRDS 








— 


— 


— 


— 


— 





_- 





— 











ERRM$ 


Null 


Null 


— 


— 


— 


— 


— 


Null 


— 


Null 


— 


Null 


— 


_ 


DATA Pointer 


None 


None 


None 


None 


None 


None 


None 


1st main 


None 


1st main 


— 


1st main 


1st sub 


Pre-ent 


LEXICAL ORDER IS 


Stand. 


Stand. 


— 


— 


— 


— ■ 


— 


— 


— 


_ 


— 


_ 


— 


— 


MASS STORAGE IS 


Note 12 


Note 12 


_ 


_ 


_ 


_ 


_ 


_ 


— 


— 














CHECKREAD ON/OFF 


Off 


Off 


— 


— 


— 


— 


— 


— 


— 


— 


— 


_ 


— 


— 


Angle Mode 


RAD 


RAD 


RAD 


RAD 


— 


— 


RAD 


RAD 


RAD 


RAD 


_ 


RAD 


— 


Prcent 


Random Number Seed 


Note 13 


Note 13 


Note 13 


— 


— 


— 


— 


Note 13 


— 


Note 13 


— 


Note 13 


— 


— 


DET 











— 


— 


— 


— 


— 


— 


— 


— 





— 


_ 


TRANSFER 


None 


Aborts 


Note 17 


Waits 


Aborts 


Waits 


None 


Note 18 


None 


Waits 


— 


None 


— 


Note 19 


TRACE ALL 


Off 


Off 


Off 


— 


— 


— 


_ 


— 


— 


— 















— = Unchanged 
Pre-ent = As existed previous to entry into the subprogram. 
In cnt. = Access to variables in current context only. 
1st main = Pointer set to first DATA statement in main program. 
1st sub = F'ointer set to first DATA statement in subprogram, 
sub clsd = All local I/O path names are closed at subexit. 
Waits = Operation waits until TRANSFER completes. 



Note 1: Only those allocated in the main program are available. 

Note 2: Pressing the STOP key is identical in function to executing STOP. Editing or altering a paused program causes the program to go 

into the stof)ped state. 

Note 3: Alpha is turned on automatically by typing on the input line, by writing to the display line, or by an output to the message line. 

Note 4: Modified according to the statement or command parameters and file contents. 

Note 5: Any new binary programs in the file are loaded. 

Note 6: Includes cursor position, INS CHR mode, ANY CHAR sequence state, but not tabs, auto-repeat rate, and auto-repeat delay. 

(These last three are defaulted only at SCF5ATCH A and Power On. ) 

Note 7: The system priority changes at SUB entry if the subroutine was invoked by an ON <event> CALL. 

Note 8: See the appropriate keyword. 

Note 9: As specified by the new environment or program. 

Note 10: A COM mismatch between programs will close I/O path names. If I/O path names exist in a labeled COM, and a LOAD or GET 

brings in a pirogram which does not contain that labeled COM, those 1/0 path names are closed. 

Note 11: Numeric variables are set to 0, and string lengths are set to 0. 

Note 12: The default mass storage device is INTERNAL (the right-hand drive) on the 9826 and 9836. See the 9816 Installation Manual for 

information on its default mass storage device. 



Note 13: 
Note 14: 
Note 15: 
Note 16: 
Note 17: 
Note 18: 
Note 19: 



The default random number seed is INT(PI x (2^^ - 2)/180). This is equal to 37 480 660. 

The default TIMEDATE is 2.086 629 12 E-Hl (midnight March 1, 1900, Julian time). 

Alter a RESET, the CRT print position is in column one of the next line below the print position before the RESET. 

Tilling aid labels are displayed unless a program is in the RUN state. 

Qperation waits until TRANSFER completes unless both 1/0 path names are in COM. 

Oiperation waits until TFIANSFER completes unless both I/O path names are in a COM area preserved during the LOAD. 

Operation waits until TF5ANSFER completes if the TRANSFER uses a local I/O path name. 
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Further Comments 

The PAUSE key, the programmed PAUSE statement, and executing PAUSE from the keyboard all have identical effects. The only 
permanent effects of the sequence "PAUSE. ..CONTINUE" on a running program are; 

1. Delay in execution. 

2. Second and subsequent interrupt events of a given type are ignored, 

3. INPUT. LINPUT, and ENTER 2 statements will be restarted 

4. ON KEY and ON KNOB are temporarily deactivated (i.e. not logged or executed) dunng the pause. 

5. A TRANSFER may complete during the pause, causing ON EOT to be serviced at the next end-of-line. 

Fatal program errors (i.e. those not trapped by ON ERROR) have the following effects: 

— a PAUSE 

— a beep 

— an error message in the message line 

— setting the values of the ERRL, the ERRN, and possibly the ERRDS functions 

— setting the default EDIT line number to the number of the line in which the error occurred. 

Autostart is equivalent to: Power On. LOAD "AUTOST", RUN. 

CLR 10 terminates ENTER and OUTPUT on all interfaces, handshake setup operations, HP-IB control operations, DISP, ENTER 
from CRT or keyboard. CAT. LIST, external plotter output, and output to the PRINTER IS. PRINTALL IS, and DUMP DEVICE IS 
devices when they are external. CLR 10 does not terminate CONTROL. STATUS. READIO. WRITEIO. TRANSFER, real-time clock 
operations, mass storage operations (other than CAT), OUTPUT 2 (keyboard), or message line output 

CLR 10 clears any pending closure key action. 

If CLR lO is used to abort a DUMP GRAPHICS to an external device, the external device may be in the middle of an escape-code 
sequence. Thus, it might be counting characters to determine when to return to normal mode (from graphics mode). This means that a 
subsequent I/O operation to the same device may yield "strange" results. Handling this situation is the responsibility of the user and is 
beyond the scope of the firmware provided with the product. Sending 75 ASCII nulls is one way to "clear" the 9876 Graphics Printer. 
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Graphic Reset Table 







n 


^ 


h 
5 




Note 2 








Power 
On 


n 
> 


O 
I 


n 


RESET 


END/ 
STOP 


GINIT 


Main 
Prerun 


PLOTTER IS 


CRT 


CRT 


_ 


— 


CRT 


— 


CRT 


— 


Graphics Memory 


Clear 


Clear 


— 


— 


Note 1 


— 


Note 1 


- 


VIEWPORT 


hrd clip 


hrd clip 


— 


- 


hrd clip 


— 


hrd clip 


— 


X and Y Scaling (unit of measure) 


GDU 


GDU 


— 


— 


GDU 


- 


GDU 


- 


Soft Clip 


hrd clip 


hrd clip 


- 


- 


hrd clip 


- 


hrd clip 


- 


Current Clip 


hrd clip 


hrd clip 


- 


- 


hrd clip 


- 


hrd clip 


- 


CLIP ON/OFF 


Off 


Off 


- 


- 


Off 


- 


Oft 


- 


PIVOT 








— 


— 





— 





— 


AREA PEN 


1 


1 


— 


— 


1 


- 


1 


- 


PEN 


1 


1 


— 


— 


1 


— 


1 


— 


LINE TYPE 


L5 


L5 


— 


— 


1.5 


— 


1.5 


- 


Pen Position 


0.0 


0.0 


- 


— 


0.0 


— 


0.0 


— 


LORG 


1 


1 


— 


— 


1 


— 


1 


— 


CSIZE 


5.6 


5., 6 


— 


— 


5.. 6 


— 


5..6 


- 


LDIR 








— 


— 





- 





- 


PDIR 








— 


— 





— 





- 


GRAPHICS ON OFF 


Off 


Off 


— 


— 


— 


— 


— 


- 


ALPHA ON OFF (Note 3) 


On 


On 


On 


On 


On 


On 


— 


- 


DUMP DEVICE IS 


701 


701 


— 


- 


— 


— 


— 


- 


GRAPHICS INPUT IS 


None 


None 


— 


— 


None 


- 


None 


— 


TRACK . ON OFF 


Off 


Off 


— 


- 


Off 


- 


Off 


- 


Color Map (Note 41 


Off 


Off 


— 


- 


Note 5 


- 


Notes 


- 


Drawing Mode 


Norm 


Norm 


— 


_ 


Norm 


_ 


Norm 


— 



— = Unchanged 
hrd clip = The default hard clip boundaries of the CRT. 



Note 1: Although RESET leaves the graphics memory unchanged, it will be cleared upon execution of the next graphics statement that sets 
a default plotter following the RESET. 

Note 2: Pressing the STOP key is identical to executing STOP. Altering a paused program causes the program to go into the stopped state. 
Note 3: Alpha is turned on automatically by typing on the input line, by writing to the display line, or by an output to the message line. 
Note 4: With color map off. 8 standard colors are available. With color map on, 16 user-defined colors are available. See PLOTTER IS. 
Note 5: Although the color map remains unchanged, it is changed if a graphics statement selects the device as a default plotter. 
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Interface Reset Table 







n 


S 




Notes 






Note 6 












Power 


> 




BASIC 


END/ 


LOAD 


GET 


Reset 


Main 


SUB 


SUB 


CLR 




Or^ 


n 


RESET 


STOP 






Cmd 


Prerun 


Enti-y 


Exit 


I/O 


GPIO Card 


























Intemipt Enable Bit 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


„.. 


— 


- 


Active Timeout Counter 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


- 


Clear 


- 


„. 


- 


Enable Interrupt Mask 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


..... 


— 


- 


Hardivare Reset of Card (PRESET) 


Reset 


Note 1 


Notel 


Reset 


Notel 


Notel 


Note 1 


Reset 


Notel 


- 


- 


Notel 


PSTS Error Flag 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


- 


— 


- 


RS-232 Card 


























Intenupt Enable Bit 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


— 


— 


Active Timeout Counter 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


.„ 


Clear 




-- 


— 


Enable Interrupt Mask 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


- 


— 


Hardivare Reset of Card 


Reset 


Reset 


— 


Reset 


— 


— 


- 


Reset 


- 


- 


-- 


— 


Data Rate/Character Format 


Swtch 


Swtch 


— 


— 


~ 


— 


— 


- 


— 


— 


— 


— 


RTS-DTR Latch 


Clear 


Clear 


— 


— 


— 


— 


— 


Clear 


— 


— 


-- 


— 


Request to Send Line 


Clear 


Clear 


— 


Clear 


— 


— 


- 


Clear 


- 


_. 


~ 


Note 2 


Data Terminal Ready Line 


Clear 


Clear 


— 


Clear 


— 


— 


- 


Clear 


— 




- 


Note 2 


Line Status Register 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


^- 


~ 


Clear 


Modem Status Register 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


- 


— 


Clear 


Data In Buffer 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


Empty 


_.. 


- 


Empty 


Error Pend, Rag 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


— 


Clear 


HP IB 


























Intenupt Enable Bit 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 




— 


.— 


Active Timeout Counter 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 




Clear 


_.. 


— 


— 


Intenupt Enable Mask 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


— 


— 


User Interrupt Status 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


„_ 


— 


— 


Serial Poll Register 


Clear 


Clear 


— 


Clear 


— 


— 


— 


Clear 


— 


— 


— 


— 


Parallel Poll Register 


Clear 


Clear 


- 


Clear 


— 


— 


- 


Clear 


— 


- 


— 


— 


My Address Register 


Note 4 


Note 4 


— 


— 


— 


— 


- 


- 


- 




- 


- 


IPC Sent 


Note :i 


Note 3 


- 


Note 3 


- 


— 


~ 


Note 3 


- 


^- 


~ 


— 


REN Set True 


Note 3 


Note 3 


— 


Note 3 


— 


— 


— 


Note 3 


— 


— 


- 


— 


Data Communications 


























Interrupt Enable Bit 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


— 


— 


Active Timeout Counter 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


Clear 


_- 


~ 


— 


Interrupt Enable Mask 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


— 


— 


Hardware Reset of Card 


Reset 


Note? 


- 


Reset 


— 


— 


- 


Note? 


— 


_. 


— 


— 


Line State 


Dscon 


Dscor 


— 


Dscon 


— 


— 


- 


Dscon 


- 


- 


— 


— 


Data Buffers 


Empty 


Empty 


- 


Empty 


- 


- 


~ 


Empty 


- 


" 


— 


- 


Protocol Selection (Async or Data Link) 


Swtch 


Notes 


- 


Swtch 


- 


- 


- 


Notes 


- 


- 


~ 


— 


Protocol Options 


Swtch 


Swtch 


— 


Swtch 


— 


— 


- 


Swtch 


— 


- 


— 


— 


BCD Card 


























Intenupt Enable Bit 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


- 


^ 


— 


Active Timeout Counter 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


— 


Clear 


- 


— 


— 


Intenupt Enable Mask 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


Clear 


_„ 


— 


— 


Hardware Reset of Card 


Reset 


Note 1 


Note 1 


Note 1 


Notel 


Note 1 


Note 1 


Reset 


Note 1 


— 


— 


Note 1 


Rewind Dnver 


Rwd 


Rwd 


Rwd 


Rwd 


Rwd 


Rwd 


Rwd 


Rwd 


Rwd 


- 


— 


Rwd 


BCD/Binary Mode 


Swtch 


Swtch 


— 





— 














__ 
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n 


^ 




Notes 






Note 6 












Power 


> 


5 


BASIC 


END/ 


LOAD 


GET 


Reset 


Main 


SUB 


SUB 


CLR 




On 


n 


RESET 


STOP 






Cmd 


Prerun 


Entry 


Exit 


I/O 


EPROM Prosrammei 


























Hardware Reset of Card 


Reset 


Reset 


— 


Reset 


— 


— 


- 


Reset 


— 


— 


- 


— 


Programming Time Register 


Clear 


Clear 


— 


- 


- 


- 


- 


Clear 


- 


- 


- 


- 


Target Address Register 


Clear 


Clear 


— 


— 


— 


— 


— 


Clear 


— 


— 


— 


— 



— = Unchanged 
Swtch = Set according to the switches on the interface card 
Dscon = A disconnect is performed 



Note 1: Reset only if card is not ready. 

Note 2: Cleared only if corresponding modem control line is not set. 

Note 3: Sent only if System Controller. 

Note 4: If System Controller and Active Controller, address is set to 21. Otherwise, it is set to 20. 

Note 5: Pressing the STOP key is identical in function to executing STOP or END. Editing or altering a paused program causes the 

program to go into the stopped state. 

Note 6: Caused by sending a non-zero value to CONTROL register 0. 

Note 7; This is a "soft reset," which does not include an interface self-test or a reconfiguration of protocol. 

Note 8; Set according to the value used in the most recent CONTROL statement directed to Register 3. If there has been no 

CONTROL 3 statement, the switch settings are used. 
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Second Byte of Non-ASCII Key Sequences (String) 

Holding the CTRL key and pressing a non-ASCII key generates a two-character sequence on the 
CRT. The first character is an "inverse-video" K. This table can be used to look up the key that 
corresponds to the second character of the sequence. (On the small 98203A keyboard, some 
non-ASCII keys generate ASCII characters when they are pressed while holding the CTRL key.) 



Character 


Value 


Key 


spare 




1 


1 


33 
35 


(IfOPl 

I 


( cm LN ) 


$ 


36 


(any charJ 


1. 


37 


(clr-end) 


i,. 


38 


(>tecll 




39 


r^vi 


( 


40 


( SHIFT )-( TAB ) 


) 


41 


(TAB) 


* 


42 


(INS LN) 


+ 


43 


( INS CHB ) 


, 


44 


( Next ) 


- 


45 


( DEL CHR ] 




46 


Ignored 


/ 


47 


(DEL LN) 





48 


ri^) 


1 


49 


CJlJ 


2 


50 


(TTl 


3 


51 


(TTl 


a 


52 


CJi) 


5 


53 


GlJ 


B 


54 


CXI) 


7 


55 


^^'^ 


8 


56 


nri 


9 


57 


nn 




58 


( SHIFT ) -svstem( ^6 Y 


! 


59 


( SHIFT ) -svstem( /7 Y 


_ 


60 
61 


CZD 


( resultJ 


7 


62 
63 


r^"i 


( recall ) 


A 


64 
65 


( SHIFT ) -( RECALL ) 


( PRT ALlD 


B 
C 


66 
67 


( BACK SPACE ] 


( CONTINUE ) 


D 


68 


( EDIT ) 


E 


69 


(ENTER) 


F 


70 


[DISPLAY FCTNS) 


G 


71 


1 SHIFT )-( - \ 


H 


72 


fsiFfi-r^ 


I 


73 


(CLR I/O) 


J 
K 


74 
75 


Katakana Mode 


( CLR SCR ) 


L 


76 


( GRAPHICS ) 




77 
78 


(ALPHA) 


(DUMP GRAPHICS) 





79 


( DUMP ALPHA ) 



Character 



Value 



80 

82 
83 
84 
85 
86 
87 
88 
89 

91 
92 
93 
94 
95 

97 
98 
99 
100 
101 
102 
103 
104 
105 
106 
107 
108 
109 
110 
111 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 



Key 



pause"! 



[ RUN I 
( step '! 

(iHiFfl-C ID 
(CAPS LOCi<l 



r»D-C ZD 
( execut F] 

Roman Mode 



[ CLR TA bI 
[ SET TA bJ 

1 

(~Kio"l 

( njiT ) 
(TF) 

r"k?r ) 
Cjir) 

[ kti" ) 

Chi ] 
T^ ] 

G^L) 

(nop 

( SHIFT ) -svstem (~7l~l - 
[ SHIFT ) -svstem( 11 Y 
[ SHIFT ) -systemf n ~Y 
( SHIFT ) -svstem ( n~Y 

f SHIFT ) -u; 

( SHIR ) -usert^_ 

(SHin) -userf 

(SHIR J -user! 



. SHIR 
:SHIR 
[SHIR 
[SHIR 



-userl 
-userl 
-userl 

-userl 

(System ) 

[ Menu 1 

[ User 1 

SHIR ) -( Menu ] 



1 These characters cannot be generated by pressing the CTRL key and a non-ASCII key. If one of these characters follows CHR${255) in < 
output to the keyboard, an error is reported {E r ro r 131 Bad non-alphanumeric Kevcode.)- 

2 System and user refer to the softkey menu which is currently active. 
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Selected High-Precision Metric Conversion Factors 







To convert from 


To convert from 


English Units 


Metric Units 


English to Metric, 


Metric to English, 






multiply by: 


multiply by: 


Length 








mil 


micrometre (micron) 


2.54 xlO^* 


3.937 007 874 x 10"^ 


inch 


millimetre 


2.54x10^1;^ 


3.937 007 874 x 10"^ 


foot 


metre t 


3.048 xlO"'<r 


3.280 839 895 


mile (intl.) 


kilometre 


1.609 344* 


6.213 711922x10"' 


Area 








inch^ 


millimetre^ 


6.4516x10^* 


1.550 003 100 x 10"^ 


foot^ 


metre^ 


9.290 304 X 10"^* 


1.076 391042x10' 


milc^ 


kilometre 


2.589 988 110 


3.861 021 585 x 10"' 


acre 


hectare 


4.046 873 xlO~' 


2.471 044 


(U.S. survey) 








Volume 








inches^ 


millimetres^ 


1.638 706 4x10"* 


6.102 374 409x10"^ 


feet^ 


metres^ 


2.831684 659x10-2 


3.531466 672x10' 


ounces 


centimetres^ 


2.957 353 x 10^ 


3.381 402 X 10"2 


(U.S. fluid) 








gallon 


litre t 


3.785 412 


2.641721x10"' 


(U.S. fluid) 








Mass 








pound (avdp.) 


kilogram 


4.535 923 7x10"^* 


2.204 622 622 


ton (short) 


ton (metric) 


9.071847 4x10"'* 


1.102 311311 


Force 








ounce (force) 


dyne 


2.780 138 510x10" 


3.596 943 090 x 10"^ 


pound (force) 


newton 


4.448 221 615 


2.248 089 431 x 10"' 


Pressure 








psi 

inches of Hg 


pascal 
millibar 


6.894 757 293 x 10^ 
3.386 4x10' 


1.450 377 377 x 10"* 
2.952 9 X 10"^ 


(at32°F) 








Energy 

BTU (1ST) 


Calorie 

(kg, thermochem.) 


2.521644 007x10"' 


3.965 666 831 


BTU (1ST) 


watt-hour 


2.930 710 702x10"' 


3.412 141 633 


BTU (1ST) 
ft-lb 


joule § 
joule 


1.055 055 853x10^ 
1.355 817 948 


9.478 171 203 x 10"* 
7.375 621 493 x 10"' 



Power 

BTU(IST)/hr 

horsepower 

(mechanical) 

horsepower 

(electric) 

ft«lb/s 

Temperature 

°Rankine 
"Fahrenheit 



watt 
watt 



watt 
watt 



2.930 710 702 x 10"' 3.412 141 633 



kelvin 
"Celsius 



7.456 998 716 x 10^= 
7.46 X 10^* 
1.355 817 948 

1.8* 

°C = (°F-32) /1.8* 



1.341 022 090 X lO"-" 
1.340 482 574 x 10"^ 
7.375 621 493 x 10"' 

5.555 555 556x10"' 
''F = (°Cxl.8)+32* 



Prefix 


Symbol 


Multiplier 


exa 


E 


10'« 


peta 


P 


10'^ 


tera 


T 


10'^ 


giga 


G 


^^6 


mega 


M 


10* 


kilo 


k 


10^ 


hecto 


h 


10^ 


deka 


da 


10' 



* Exact conversion 
t Conversion redefined in 1959 
t Conversion redefined in 1964 
§ Conversion redefined in' 1956 



Note: Tiie preferred nnetric unit for 
force is the newton; for pressure, tiie 
pascal; and for energy, the joule. 



Sources 

American Society for Testing and Materials (ASTMl, "Standard for Metric Practice". Reprinted from Annual 
Booi< of ASTM Standards. 

US. Department of Commerce. National Bureau of Standards, "NBS Guidelines for the Use of the Metric 
System". Reprinted from Dimensions /NBS, (October 1977). 



Prefix 


Symbol 


Multiplier 


deci 


d 


10"' 


centi 


c 


10-2 


milli 


m 


10"^ 


micro 


H- 


10-* 


nano 


n 


10"' 


pico 


P 


10"'2 


femto 


f 


10 '^ 


atto 


a 


10"'« 
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Subject Index 



a 

ASCII: 

Data representation 12,146,160 

ASSIGN: 

Determining outcome of 159 

I/O path names 26 

Specifying attributes 147 

Attributes: 

Assigning 147 

BYTE 149 

CONVERT 154 

EOL 156 

FORMAT OFF 33,147 

FORMAT ON 33,145 

PARITY 157 

RETURN 159 

WORD 150 

b 

Backplane 6 

BCD: 

Binary mode 417,428 

Configuration 420 

Data representations 414 

ENABLE INTR 439 

ENTER 415,425 

Handshakes 422 

Installation note 413 

Interface description 414 

Interrupts 439 

ON INTR 439 

Optional format 416,432 

OUTPUT 419,435 

Register summary 440 

Reset 424 

Service routines 439 

Standard format 415,426 

Timeouts 437 

Bit-mapped displays 97 

Bits and bytes 11 



Break: 

Command 149 

Datacomm 280 

Serial 339 

Buffers: 

Assigning I/O path names 177 

Creating 177 

Description 176 

Pointers 178,201 

Registers 203 

Bus 6 

Bus sequences 210 

BYTE attribute 149 



c 

CALL 170 

Chapter Preview 2 

Computer backplane 6 

Computer resource 5 

CONTROL statement 75 

Conversions: 

BY INDEX 154 

BY PAIRS 154 

Using string variable 397 

CONVERT Attribute 154 

Copying: 
CRT: 

Bit-mapped 100,104,107,108 

Control characters 104 

Description 97 

Disabling the cursor 114 

DISPline 100,113 

Display functions mode 105 

Enhancement characters 104,458 

ENTER Ill 

Insert mode 114 

Output 100 

Register summary 117 

Screen addresses 108 

Screen width 108 

Scrolling 109 

Softkey labels 115 

CRTA (display driver) 98 

CRTB (display driver) 98 



d 

Data communications basics 265 

Data representations: 

ASCII characters 12 

Design criteria 160 

FORMAT OFF 147 

FORMAT ON 146 

In general 11 

Numbers 12 

Real numbers 15 

Signed integers 13 

Summary 163 

Datacomm: 

Async diagram 266 

Async options 275 

Async protocol 266 

Block check 267 

Break 280 

Cable options 314 

Character frame 266,280 

Connections 272 

Control blocks 268 

Data link options 281 

Data link protocol 267 

Data messages 270 

Default settings 273 

Device identifier 267 

Error recovery 300 

Example programs 295,302 

Group identifier 267 

Handshakes 278,282 

Interrupt mask 287 

Interrupts 286 

Modems 283 

Normal mode 267 

Overview 271 

Parity 266,280 

Protocol selection 274 

Register summary 318 

Reset 274 

Service routines 289 

Start bit 266,280 

Stop bit 280 

Stop bits 266 

Time gap 266,280 

Timeouts 277 

Transparent mode 267 

Default display device 98 

Destination 6 



Device selectors: 

Description 23 

HP-IB 24,207 

Primary address 24,207 

Directing data flow 21 

Display drivers 98 

Display regions 99 

Display sizes 99 

Display, default device 98 

Displays,types of 97 



e 

ENABLE INTR: 

BCD 439 

Datacomm 287 

General 93 

GPIO 398 

HP-IB 215 

Enabling interrupt events 92 

END: 

With datacomm interface 41,54 

With free-field OUTPUT 40 

With HP-IB 53 

With HP-IB interface 41 

With OUTPUT USING 52 

ENTER: 

BCD 415,425 

Buffers 175,183,193 

CRT 112 

Datacomm 271 

Destination items 20 

EOI termination 62,70 

Example statement 19 

Free-field 55 

From files 162 

GPIO 393 

HP-IB 208,210,229,237 

Keyboard 128 

Nested images 72 

Numeric data 56 

Re-use 72 

Repeat factors 72 

Serial 336 

String data 60 

String variables 22,167 

Termination 62,70 

Using images 64 

Entering Data 55 

EOL sequence 39,156 



EPROM: 

Initializing 452 

Media 449 

Memory 448 

Memory address 450 

Memory card 447 

Programmer card 447 

Programming 453 

Select code 449 

Storing data 454 

Storing programs 457 

Error recovery: 

Datacomm 300 

Serial 338 

Extend char 124 

f 

Firmware 5,16 

FORMAT OFF 147 

FORMAT ON 145 

Free-field convention 35 



9 

GPIO: 

Byte mode 390 

Configuration 376 

Control lines 405 

Data representations 390,395 

Description 376 

ENTER 393 

Example programs 401 

Handshakes 378 

Installation 375 

Interrupt;; 398 

ON INTR 398 

OUTPUT 392 

PSTSline 406 

READIO and WRITEIO 409 

Register summary 407 

Reset 389 

Service routines 399 

Status lines 405 

Timeouts 393 

Word mode 392 



h 

Handshakes: 

BCD 422 

Datacomm 278,282 

GPIO 378 

HP-IB 241 

In general 17 

Serial 336 

Hardware 5 

Hardware priority 89 

HIL keyboards 122 

HIL, re-conflguring 123 

HP 46020 (HP-HIL keyboard) 122 

HP 98203A (keyboard) 121 

HP 98203B (keyboard) 122 

HP 98546 (display compatibility interface) . . 98 

HP 98626a (serial interface) 355 

HP 98644 (serial interface) 356 

HP 98700 (display confa-oUer) 98 

HP-HIL keyboards 122 

HP-IB: 

ABORT statement 215 

Active Controller 209 

Advanced bus management 219 

ATN 210,242 

Bus 205 

Bus commands and codes 221 

Bus lines 244 

Bus messages 219 

CLEAR statement 214 

Commands 210 

Control lines 241 

Controller status and address 227 

DAV 241 

ENABLE INTR 215 

EOI 242 

Example bus sequences 210 

General structure 209 

Handshake lines 241 

Handshakes 241 

IFC 242 

Interface 205 

Interface status 237 

Interrupt registers 230 

Intenrupts 215,229 

Listen addresses 222 

Listener 209,210 

LOCAL statement 213 

Message mnemonics 225 



Multiple listeners 211 

NDAC 241 

NDAC holdoff 240 

Non-Active Controllers 227 

NRFD 241 

ON INTR 215,229 

Pass control command 224,228 

PPOLL statement 217 

Primary address 24,207 

Register summary 245 

REMOTE statement 212 

REN 242 

Secondary addressing 211 

Secondary commands 224,230,239 

Sending data 225 

SPOLL statement 218 

SRQ 242 

Statement summary 212 

System controller 209 

Talk addresses 222 

Talker 209,210 

TRIGGER statement 214 

Unlisten 210 

Unlisten command 222 

Untalk command 222 



1 

I/O path names: 

ASCII files 162 

Assigning 26 

Attributes 33.145 

BOAT files 161 

Benefits of using 31 

Buffers 177 

Closing 28 

Data type 27 

Description 25 

In COM 31 

Local 29 

Pass parameters 30 

Re-assigning 28 

Register summary 79 

Table 27,76 

I/O: 

Backplane 6 

Buffers 177 

Description 6,16 

Examples 18 

Statements 16 

String variables 22.163 



Images: 

Binary 47,69 

ENTER definitions 64 

Nested 52,72 

Numeric 44,66 

OUTPUT definitions 44 

Re-use 51,72 

Repeat factors 50,72 

Special 48 

Specifiers 42,64 

String 46,67 

Termination 49,71 

INDEX Conversions 154 

INPUT Statement 128 

INTEGER: 

Internal representation 13 

With FORMAT OFF attribute 148 

Interface select code 23 

Interfaces: 

Events 81 

Function of 7 

Interrupts 91 

Overview 9 

Select code table 23.463 

Timeouts 96 

Interfacing concepts 5 

Internal: 

Format for files 148 

Numeric formats 12,13,15 

Interrupts: 

BCD 439 

Conditions 95 

Datacomm 287 

Enabling 91 

GPIO 398 

Hardware priority 87 

HP-IB 229 

HP-IB (Non-Active Controller) 229 

HP-IB (registers) 230 

HP-IB (SRQ) 215 

Mask 92 

Overview 91 

Re-enabling 93 

Software priority 84 

Item separators 36,56 

Item terminators 36,56 



k 

KBD$ 136 

Key sequences: 

non-ASCII 130 

Keyboard, choosing primary 123 

Keyboard: 

Auto-repeat 121 

Buffer size 136 

CAPS LOCK mode 126 

Closure keys 132 

Control characters 125 

Description 121 

Disabling 138 

Enhanced control 136 

ENTER 128 

Functional key groups 124 

HP-HIL 122 

Key sequences tables 458 

Knob 135,138 

Lock out 138,140 

OUTPUT 130 

PRINTALL mode 126 

Register summary 141 

Simulated EOI 129 

Trapping keystrokes 136 

Trapping softkeys and KNOB 138 

Types 121 

KNOBX 134,135 

KNOBY 134,135 

1 

LIF ASCII files 162 

LOADSUB ALL FROM 173 

Logic Levels 11 



m 



n 

Names: 

I/O path 26 

Non-Active Controller 227 

Non-ASCII key sequences 130 

Number builder 56 



o 

OFFKBD 136 

ON ERROR 338 

ON INTR: 

BCD 439 

Datacomm 287 

GPIO 398 

HP-IB 215,229 

Powerfail 362 

ON KBD 136 

ON KEY 82 

ON KNOB 134,138 

OUTPUT: 

ASCII files 162,165 

BCD 419,435 

BDAT files 161 

Buffers 182,190,193,196 

CRT 101 

Datacomm 271 

Example statement 18 

Free-field 35 

GPIO 392 

HP-IB 208,210,223 

Keyboard 130 

Serial 336 

Source items 18 

String variables 22,163 

Using images 42 

Outputting data 35 



Manual Organization 1 

Mouse 135,138 



p 

PAIRS conversions 155 

PARITY attribute 157 

Powerfail: 

Clock 361 

Continuous memory 361 

Interrupts 362 

Overview 360 

Register summary 371 

Service routines 365 

Timers 361 

Primary address 24,207 

Primary keyboard choosing 123 

Priority, software 84 



r 

REAL: 

FORMAT OFF representation 148 

Internal representation 15 

Re-configuring HIL 123 

Regions of displays 99 

Register summary: 

BCD 440 

Buffers 203 

CRT 117 

Datacomm 318 

GPIO 407 

HP-IB 245 

I/O path 79 

Keyboard 141 

Powerfail 371 

Serial 351 

Registers: 

Access 73 

CONTROL 75 

Description 16 

I/O path 76 

Interface 74 

READIO 79 

STATUS 74 

WRITEIO 79 

Requesting Service 234 

Reset: 

BCD 424 

Buffers 187 

Datacomm 274 

GPIO 389 

HP-IB 245 

Interface table 468 



Master table 464 

Serial 334,351 

Resource: 

I/O, definition of 5 

Specifying 16,22 

Return 124,128,129 

RETURN attribute 159 

RS-232C: 

Interface 329 

Interface cable 314,345,346 

List of signals 316,349 

With datacomm 265 



s 

SCRATCH A 115 

Select code table 23 

Serial interface: 

Built-in 98626 355 

Built-in 98644 356 

Series 300 Built-in 98644 interface 

differences 358 

Serial: 

Async 329 

Baud rates 333 

Character format 335 

Character frame 330 

Defaults 333 

ENTER 336 

Error detection 337 

Error recovery 338 

Handshakes 336 

Modem handshake 336 

Modem-line switches 333 

OUTPUT 336 

Overview 332 

Parity bit 330,335 

READIO and WRITEIO 340 

Register summary 351 

Reset 334 

Self-test 340 

Signal functions 345 

Special messages 339 

Start bit 329,335 

Stop bit 330,335 

UART 330 

Service routines: 

BCD 439 

Datacomm 289 

Example 82 

GPIO 399 



HP-IB 216,229,239 

Interrupts 91 

Logging 84,89 

Powerfaii 365 

Serial 337 

Set-up 82,91 

Software priority 84 

System priority 86 

Size of displays 99 

Softkey Labels 116 

Softkeys 133,138 

Software 5 

Software priority 84 

Source 6 

SRQ intenrupts 215 

Standard numeric format 36 

Standard string format 36 

STATUS statement 74 

Stepwise refinement 171 

String variables: 

Buffers 177 

I/O 22,163 

Subprograms 171 

SYSTEM 97,115 

System Controller 209 

System priority 86 

t 

Timeouts: 

BCD 437 

Datacomm 277 

GPIO 393 

Limitations 96 

Set-up 96 

Top-down design 169 

Transfer: 

Attributes 200 

Choosing parameters 183 

Concurrency 192 

Considerations 192 



Error reporting 194 

Examples 189 

Initiating 182 

Interactions with interrupts 198 

Introduction 175 

Method 197 

ON EOR 186 

ON EOT 186 

Performance 195 

Rates 197 

Restrictions 198 

Statement 180 

Suspension 194 

Termination 187 

Types of 181 

WAIT FOR EOR 187 

WAIT FOR EOT 187 

Trapping: 

Knob 135 

Two's-complement 13 

Type of resource 21 

Types of displays 97 

Types of files 160 

Types of keyboards 121 



u 

Underlining 106 

Unified I/O: 

Applications of 163 

Description of 145,160 

User (HIL) key menu 99 



w 

WORD Attribute 150 

Word, definition of 11 

Writing to BDAT files 161,172 
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